| class RChangeNotifier : public RHandleBase |
A handle to a change notifier.
The change notifier itself is a kernel object.
| Public Member Functions | |
|---|---|
| IMPORT_C TInt | Create () |
| IMPORT_C TInt | Logon ( TRequestStatus &) |
| IMPORT_C TInt | LogonCancel () |
| Inherited Enumerations | |
|---|---|
| RHandleBase:TAttributes | |
| Inherited Attributes | |
|---|---|
| RHandleBase::iHandle | |
| IMPORT_C TInt | Create | ( | ) |
Creates a change notifier, and opens this handle to that change notifier.
Ownership of this change notifier is vested in the current process.
| IMPORT_C TInt | Logon | ( | TRequestStatus & | aStatus | ) | const |
Issues a request for notification when changes occur in the environment.
A switch in locale, or crossing over past midnight, are examples of changes that are reported.
When a change in the environment occurs, the request completes and the TRquestStatus object will contain one or more of the bit values defined by the TChanges enum.
Alternatively, if an outstanding request is cancelled by a call to this handle's LogonCancel() member function, then the request completes with a KErrCancel.
Note that if this is the first notification request after creation of the change notifier, then this request completes immediately.
| TRequestStatus & aStatus | A reference to the request status object. |
| IMPORT_C TInt | LogonCancel | ( | ) | const |
Cancels an outstanding change notification request.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.