BluetoothFindFirstRadio-Funktion (bluetoothapis.h)
Die Funktion BluetoothFindFirstRadio beginnt mit der Enumeration lokaler Bluetooth-Funkgeräte.
Syntax
HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio(
const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp,
[out] HANDLE *phRadio
);
Parameter
pbtfrp
Zeiger auf eine BLUETOOTH_FIND_RADIO_PARAMS-Struktur . Der dwSize-Member der BLUETOOTH_FIND_RADIO_PARAMS Struktur, auf die pbtfrp verweist, muss der Größe der Struktur entsprechen.
[out] phRadio
Zeiger auf den Ort, an dem der erste aufgezählte Funkhandle zurückgegeben wird. Wenn es nicht mehr benötigt wird, muss dieses Handle über CloseHandle geschlossen werden.
Rückgabewert
Zusätzlich zum durch phRadio angegebenen Handle wird durch Aufrufen dieser Funktion auch ein HBLUETOOTH_RADIO_FIND Handle für die Verwendung mit der BluetoothFindNextRadio-Funktion erstellt. Wenn dieses Handle nicht mehr benötigt wird, muss es über bluetoothFindRadioClose geschlossen werden.
Gibt BEI Einem Fehler NULL zurück. Rufen Sie die GetLastError-Funktion auf, um weitere Informationen zum Fehler zu erhalten. In der folgenden Tabelle werden häufige Fehler beschrieben:
| Rückgabecode | Beschreibung |
|---|---|
|
Es wurden keine Bluetooth-Funkgeräte gefunden. |
|
Der pbtfrp-Parameter ist NULL. |
|
Die Struktur, auf die pbtfrp verweist, ist nicht die richtige Größe. |
|
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 |