Funzione BluetoothRegisterForAuthentication (bluetoothapis.h)

Articolo
02/23/2024

La funzione BluetoothRegisterForAuthentication registra una funzione di callback chiamata quando un determinato dispositivo Bluetooth richiede l'autenticazione.

Nota Quando si sviluppa per Windows Vista SP2 e Windows 7, è consigliabile usare BluetoothRegisterForAuthenticationEx .

Sintassi

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

Parametri

pbtdi

Puntatore a una struttura BLUETOOTH_DEVICE_INFO . Il membro Address viene utilizzato per il confronto.

phRegHandle

Puntatore a una struttura in cui è archiviato l'HANDLE di registrazione. Chiamare BluetoothUnregisterAuthentication per chiudere l'handle.

pfnCallback

Funzione da chiamare quando si verifica l'evento di autenticazione. La funzione deve corrispondere al prototipo descritto in PFN_AUTHENTICATION_CALLBACK.

pvParam

Parametro facoltativo da passare tramite la funzione di callback.

Valore restituito

Restituisce ERROR_SUCCESS al completamento corretto e viene restituito un handle di registrazione valido in phRegHandle. Qualsiasi altro valore restituito indica un errore.

Chiamare la funzione GetLastError per ottenere altre informazioni sull'errore. La tabella seguente descrive un errore comune:

Codice restituito	Descrizione
ERROR_OUTOFMEMORY	Memoria insufficiente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Libreria	Bthprops.lib
DLL	bthprops.cpl