PFN_AUTHENTICATION_CALLBACK callback function (bluetoothapis.h)

  • Article

The PFN_AUTHENTICATION_CALLBACK function is a callback function prototype used in conjunction with the BluetoothRegisterForAuthentication function.

Note  When developing for Windows Vista SP2 and Windows 7 the use of PFN_AUTHENTICATION_CALLBACK_EX is recommended.
 

Syntax

PFN_AUTHENTICATION_CALLBACK PfnAuthenticationCallback;

BOOL PfnAuthenticationCallback(
  LPVOID pvParam,
  PBLUETOOTH_DEVICE_INFO pDevice
)
{...}

Parameters

pvParam

Optional. A context pointer previously passed into the BluetoothRegisterForAuthentication function.

pDevice

A remote Bluetooth device requesting authentication. The remote address is the same address used to register the callback during the previous call to the BluetoothRegisterForAuthentication function.

Return value

The return value from this function is ignored by the system.

Remarks

A caller can register for multiple addresses with the same callback function.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)

See also

BluetoothRegisterForAuthentication