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
ERROR_NO_MORE_ITEMS	Es wurden keine Bluetooth-Funkgeräte gefunden.
ERROR_INVALID_PARAMETER	Der pbtfrp-Parameter ist NULL.
ERROR_REVISION_MISMATCH	Die Struktur, auf die pbtfrp verweist, ist nicht die richtige Größe.
ERROR_OUTOFMEMORY	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

Weitere Informationen

BLUETOOTH_FIND_RADIO_PARAMS

BluetoothFindNextRadio

BluetoothFindRadioClose

BluetoothGetRadioInfo

GetLastError