BluetoothRegisterForAuthentication function (bluetoothapis.h)

The BluetoothRegisterForAuthentication function registers a callback function that is called when a particular Bluetooth device requests authentication.

Syntax

DWORD BluetoothRegisterForAuthentication(
  const BLUETOOTH_DEVICE_INFO            *pbtdi,
  HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandle,
  PFN_AUTHENTICATION_CALLBACK            pfnCallback,
  PVOID                                  pvParam
);

Parameters

pbtdi

Pointer to a BLUETOOTH_DEVICE_INFO structure. The Address member is used for comparison.

phRegHandle

Pointer to a structure in which the registration HANDLE is stored. Call the BluetoothUnregisterAuthentication to close the handle.

pfnCallback

Function to be called when the authentication event occurs. The function should match the prototype described in PFN_AUTHENTICATION_CALLBACK.

pvParam

Optional parameter to be passed through the callback function.

Return value

Returns ERROR_SUCCESS upon successful completion, and a valid registration handle was returned in phRegHandle. Any other return value indicates failure.

Call the GetLastError function to obtain more information about the error. The following table describes a common error:

Requirements

See also

BLUETOOTH_DEVICE_INFO

BluetoothAuthenticateDevice

BluetoothAuthenticateMultipleDevices

BluetoothEnableDiscovery

BluetoothEnableIncomingConnections

BluetoothIsConnectable

BluetoothIsDiscoverable

BluetoothRegisterForAuthentication

BluetoothSendAuthenticationResponse

BluetoothUnregisterAuthentication