BluetoothRegisterForAuthentication-Funktion (bluetoothapis.h)

Artikel
02/23/2024

Die BluetoothRegisterForAuthentication-Funktion registriert eine Rückruffunktion, die aufgerufen wird, wenn ein bestimmtes Bluetooth-Gerät die Authentifizierung anfordert.

Hinweis Bei der Entwicklung für Windows Vista SP2 und Windows 7 wird die Verwendung von BluetoothRegisterForAuthenticationEx empfohlen.

Syntax

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

Parameter

pbtdi

Zeiger auf eine BLUETOOTH_DEVICE_INFO-Struktur . Das Adresselement wird für den Vergleich verwendet.

phRegHandle

Zeiger auf eine Struktur, in der der Registrierungshandle gespeichert ist. Rufen Sie bluetoothUnregisterAuthentication auf, um das Handle zu schließen.

pfnCallback

Funktion, die aufgerufen werden soll, wenn das Authentifizierungsereignis auftritt. Die Funktion sollte mit dem in PFN_AUTHENTICATION_CALLBACK beschriebenen Prototyp übereinstimmen.

pvParam

Optionaler Parameter, der über die Rückruffunktion übergeben werden soll.

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück, und ein gültiges Registrierungshandle wurde in phRegHandle zurückgegeben. Jeder andere Rückgabewert weist auf einen Fehler hin.

Rufen Sie die GetLastError-Funktion auf, um weitere Informationen zum Fehler zu erhalten. In der folgenden Tabelle wird ein häufiger Fehler beschrieben:

Rückgabecode	Beschreibung
ERROR_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Bibliothek	Bthprops.lib
DLL	bthprops.cpl