Home > Language Reference > Classes > Telephony

RegisterNotify Method

Registers a notification request.

Syntax

Public Sub RegisterNotify(ByVal eService As HbPhoneServices)

Remarks

The RegisterNotify method registers a notification request for the specified event classes. After this method returns, your application will be notified of any subsequent phone event that falls into the requested classes throught the PhoneEvent launch code.

The eService parameter specifies the event classes you wish to be notified of. It can be any combination of the following values:

For each class, the phone library sends many real time events, some of them requiring as little overhead as possible before they can be processed. It is therefore advised you only register for events of interest for your application and that you keep your start-up code as small as possible: avoid opening all your databases and loading all your preferences before you are sure this is required, as most of the time the received event won't be the one you expect.

Calling this method cancels any notification request previously registered. You can unregister notification requests using the UnregisterNotify method.

System requirements