BluetoothSelectDevices-Funktion (bluetoothapis.h)

Die BluetoothSelectDevices-Funktion ermöglicht die Bluetooth-Geräteauswahl.

Syntax

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

Parameter

pbtsdp

Ein Zeiger auf eine BLUETOOTH_SELECT_DEVICE_PARAMS Struktur, die Bluetooth-Geräte identifiziert.

Rückgabewert

Gibt TRUE zurück, wenn ein Benutzer ein Gerät ausgewählt hat.

Gibt FALSE zurück, wenn keine gültigen Daten zurückgegeben wurden. Rufen Sie die GetLastError-Funktion auf, um Fehlerinformationen abzurufen. Die folgenden Bedingungen gelten für zurückgegebene Fehlerinformationen.

Rückgabecode	Beschreibung
ERROR_CANCELLED	Der Benutzer hat die Anforderung abgebrochen.
ERROR_INVALID_PARAMETER	Der pbtsdp-Parameter ist NULL.
ERROR_REVISION_MISMATCH	Die in pbtsdp übergebene Struktur hat eine unbekannte Größe.

Hinweise

Die BluetoothSelectDevices-Funktion öffnet ein allgemeines Dialogfeld zum Auswählen von Bluetooth-Geräten. Die Liste der dem Benutzer angezeigten Geräte wird durch die Flags und Einstellungen bestimmt, die der Aufrufer im pbtsdp-Parameter angibt.

Wenn BluetoothSelectDevicesTRUE zurückgibt, verweist das pDevices-Element der BLUETOOTH_SELECT_DEVICE_PARAMS-Struktur auf gültige Daten. Der Aufrufer sollte überprüfen, ob die fAuthenticated - und fRememembered-Flags in der BLUETOOTH_SELECT_DEVICE_PARAMS-Struktur verwendet werden, um zu ermitteln, welche Geräte erfolgreich authentifiziert wurden und welche Geräte für den Benutzer gültig sind. Rufen Sie die BluetoothSelectDevicesFree-Funktion auf, um Ressourcen nur dann freizugeben, wenn die BluetoothSelectDevices-FunktionTRUE zurückgibt.

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_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK