Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
---|---|
|
Der Benutzer hat die Anforderung abgebrochen. |
|
Der pbtsdp-Parameter ist NULL. |
|
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 |