// Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
// Client observer class
// 
//

#include "UD_STD.H"

// Class RDbNotifier

EXPORT_C TInt RDbNotifier::Open(RDbDatabase& aDatabase)
/** Opens a DBMS change notifier on a database.

Note that a notifier cannot be opened on a client side database.

@param aDatabase The database to be observed.
@return KErrNone if successful, otherwise another of the system-wide error 
codes. */
	{
	TRAPD(r,iNotifier=aDatabase.iDatabase->NotifierL());
	return r;
	}
 
EXPORT_C void RDbNotifier::Close()
/** Closes a DBMS change notifier. Any outstanding notification request is automatically 
cancelled.

Note that this function can be called on a DBMS change notifier that has already 
been closed. */
	{
	iNotifier.Close();
	}

//LOCAL_C void Notify(RDbHandle<CDbNotifier>& aNotifier,TRequestStatus& aStatus,CDbNotifier::TType aType)
//	{
//	aNotifier->Notify(aType,aStatus);
//	}

//EXPORT_C void RDbNotifier::NotifyUnlock(TRequestStatus& aStatus)
///** Makes an asynchronous request for notification of a database event. All events, 
//including the release of all read locks, are reported.
//
//When a database event occurs, the request completes and the TRequestStatus 
//objectcontains one of the enumerators defined by the TEvent enumeration member.
//
//Alternatively, if an outstanding request is cancelled by a call to the Cancel() 
//member function of this class, then the request completes with KErrCancel.
//
//Only one notification request can be outstanding on this notifier at any one 
//time.
//
//Note that if further database events occur while a client is handling a request 
//completion, the notifier records the most significant database event and this 
//is signalled as soon as the client issues the next NotifyUnlock() or NotifyChange() 
//request.
//
//@param aStatus The request status object. If the request is cancelled, this 
//is set to KErrCancel. If the request completes normally, this is set to one 
//of the enumerator values defined by the TEvent enumeration member. */
//	{
//	::Notify(iNotifier,aStatus,CDbNotifier::EUnlock);
//	}

//EXPORT_C void RDbNotifier::NotifyChange(TRequestStatus& aStatus)
///** Makes an asynchronous request for notification of changes to the database.
//
//All events which indicate a change to the database are reported; in practice, 
//this means all database events except RDbNotifier::EUnlock.
//
//When a change event occurs, the request completes and the TRequestStatus object 
//contains one of the appropriate enumerators defined by the TEvent enumeration 
//member.
//
//Alternatively, if an outstanding request is cancelled by a call to the Cancel() 
//member function of this class, then the request completes with KErrCancel.
//
//Only one notification request can be outstanding on this notifier at any one 
//time.
//
//Note that if further database events occur while a client is handling a request 
//completion, the notifier records the most significant database event and this 
//is signalled as soon as the client issues the next NotifyUnlock() or NotifyChange() 
//request.
//
//@param aStatus The request status object. If the request is cancelled, this 
//is set to KErrCancel. If the request completes normally, this is set to one 
//of the enumerator values defined by the TEvent enumeration member. */
//	{
//	::Notify(iNotifier,aStatus,CDbNotifier::EChange);
//	}

//EXPORT_C void RDbNotifier::Cancel()
///** Cancels any outstanding notification request to this DBMS notifier.
//
//The outstanding request completes with a KErrCancel. */
//	{
//	iNotifier->Cancel();
//	}