Funzione BluetoothRegisterForAuthenticationEx (bluetoothapis.h)

Articolo
03/14/2023

La funzione BluetoothRegisterForAuthenticationEx registra un'applicazione per una richiesta pin, un confronto numerico e una funzione di callback.

Nota Questa API è supportata in Windows Vista SP2 e Windows 7.

Sintassi

DWORD BluetoothRegisterForAuthenticationEx(
  [in, optional] const BLUETOOTH_DEVICE_INFO            *pbtdiIn,
  [out]          HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandleOut,
  [in, optional] PFN_AUTHENTICATION_CALLBACK_EX         pfnCallbackIn,
  [in, optional] PVOID                                  pvParam
);

Parametri

[in, optional] pbtdiIn

Puntatore a una struttura BLUETOOTH_DEVICE_INFO che specifica l'indirizzo Bluetooth da utilizzare per il confronto.

[out] phRegHandleOut

Puntatore a un handle HBLUETOOTH_AUTHENTICATION_REGISTRATION associato all'applicazione registrata. Chiamare BluetoothUnregisterAuthentication per chiudere l'handle.

[in, optional] pfnCallbackIn

Funzione che verrà chiamata quando si verifica l'evento di autenticazione. Questa funzione deve corrispondere al prototipo di PFN_AUTHENTICATION_CALLBACK_EX.

[in, optional] pvParam

Parametro facoltativo da passare alla funzione di callback specificata da pfnCallbackIn. Questo parametro può essere qualsiasi elemento necessario per definire l'applicazione.

Valore restituito

Restituisce ERROR_SUCCESS al completamento corretto; restituisce i codici di errore seguenti in caso di errore:

Codice restituito	Descrizione
ERROR_OUTOFMEMORY	Memoria insufficiente.
Errore Win32	L'handle di registrazione fornito non è valido.

Commenti

Il chiamante deve fornire un indirizzo di callback valido e deve annullare la registrazione del callback una volta che la notifica non è più necessaria. La registrazione di un dispositivo autenticato può essere eseguita chiamando BluetoothUnregisterAuthentication.

Negli scenari in cui un'applicazione esegue la registrazione per l'autenticazione più volte, solo la prima funzione di callback registrata tramite questa funzione verrà chiamata nell'applicazione mentre è in corso l'autenticazione.

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

Vedi anche

BluetoothRegisterForAuthentication

BluetoothUnregisterAuthentication

Share via