BluetoothRegisterForAuthenticationEx-Funktion (bluetoothapis.h)
Die BluetoothRegisterForAuthenticationEx-Funktion registriert eine Anwendung für eine Pinanforderung, einen numerischen Vergleich und eine Rückruffunktion.
Syntax
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
);
Parameter
[in, optional] pbtdiIn
Ein Zeiger auf eine BLUETOOTH_DEVICE_INFO-Struktur , die die Bluetooth-Adresse angibt, die für den Vergleich verwendet werden soll.
[out] phRegHandleOut
Ein Zeiger auf ein HBLUETOOTH_AUTHENTICATION_REGISTRATION Handle, das der registrierten Anwendung zugeordnet ist. Rufen Sie BluetoothUnregisterAuthentication auf, um das Handle zu schließen.
[in, optional] pfnCallbackIn
Die Funktion, die aufgerufen wird, wenn das Authentifizierungsereignis auftritt. Diese Funktion sollte mit dem Prototyp von PFN_AUTHENTICATION_CALLBACK_EX übereinstimmen.
[in, optional] pvParam
Optionaler Parameter, der an die von pfnCallbackIn angegebene Rückruffunktion übergeben werden soll. Dieser Parameter kann alles sein, was die Anwendung definieren muss.
Rückgabewert
Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück. gibt bei einem Fehler die folgenden Fehlercodes zurück:
Rückgabecode | Beschreibung |
---|---|
|
Nicht genügend Arbeitsspeicher. |
|
Das angegebene Registrierungshandle ist ungültig. |
Hinweise
Der Aufrufer muss eine gültige Rückrufadresse angeben und die Registrierung des Rückrufs aufheben, sobald die Benachrichtigung nicht mehr erforderlich ist. Die Aufhebung der Registrierung eines authentifizierten Geräts kann durch Aufrufen von BluetoothUnregisterAuthentication erreicht werden.
In Szenarien, in denen sich eine Anwendung mehr als einmal für die Authentifizierung registriert, wird nur die erste Rückruffunktion, die über diese Funktion registriert ist, in der Anwendung aufgerufen, während die Authentifizierung ausgeführt wird.
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 |