Compartilhar via


RequestBluetoothNotifications

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 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. 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

Reference

Bluetooth Application Development Functions

Other Resources