Freigeben über


BluetoothRegisterForAuthentication-Funktion (bluetoothapis.h)

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

Weitere Informationen

BLUETOOTH_DEVICE_INFO

BluetoothAuthenticateDevice

BluetoothAuthenticateMultipleDevices

BluetoothEnableDiscovery

BluetoothEnableIncomingConnections

BluetoothIsConnectable

BluetoothIsDiscoverable

BluetoothRegisterForAuthentication

BluetoothSendAuthenticationResponse

BluetoothUnregisterAuthentication