This function is called by an application to register the class of events for which to receive notifications.

HANDLE RequestBluetoothNotifications(
  DWORD dwClass,
  HANDLE hMsgQ
);

Parameters

dwClass

[In] Class of events to receive notifications for.

hMsgQ

[In] Handle to the message queue created by the application.

Return Values

If no error occurs, then this function returns a handle to the caller. If an error occurs, then this function returns NULL.

Remarks

To register for certain class of events, specify the bitmask in dwClass. The following list show the possible values for the class of events.

• BTE_CLASS_CONNECTIONS (1)
• BTE_CLASS_PAIRING (2)
• BTE_CLASS_DEVICE (4)
• BTE_CLASS_STACK (8)

Pass the handle returned by the CreateMsgQueue function called by the application to create a message queue, in order to receive event notifications sent by the Bluetooth Stack. To terminate the event notification process, call the StopBluetoothNotifications function.

Requirements

Pocket PC: Windows Mobile 5.0 and later.
Smartphone: Windows Mobile 5.0 and later.
OS Versions: Windows CE 5.01 and later.
Header: Bt_api.h.
Link Library: Coredll.lib.

See Also

Bluetooth Application Development Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.