Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Syntax 

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 Value

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 CreateMsgQueuefunction 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 StopBluetoothNotificationsfunction. For more information about event handling, see Handling Events from the Bluetooth Stack

Requirements

Header bt_api.h
Library coredll.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also