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 |
|---|---|
|
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 |