BluetoothFindFirstRadio 関数 (bluetoothapis.h)
BluetoothFindFirstRadio 関数は、ローカル Bluetooth 無線の列挙を開始します。
構文
HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio(
const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp,
[out] HANDLE *phRadio
);
パラメーター
pbtfrp
BLUETOOTH_FIND_RADIO_PARAMS構造体へのポインター。 pbtfrp が指すBLUETOOTH_FIND_RADIO_PARAMS構造体の dwSize メンバーは、構造体のサイズと一致している必要があります。
[out] phRadio
最初に列挙された無線ハンドルが返される場所へのポインター。 不要になった場合、このハンドルは CloseHandle を使用して閉じる必要があります。
戻り値
phRadio によって示されるハンドルに加えて、この関数を呼び出すと、BluetoothFindNextRadio 関数で使用するHBLUETOOTH_RADIO_FIND ハンドルも作成されます。 このハンドルが不要になった場合は、 BluetoothFindRadioClose を使用して閉じる必要があります。
失敗した場合は NULL を 返します。 エラーの詳細については、 GetLastError 関数を呼び出します。 次の表では、一般的なエラーについて説明します。
リターン コード | 説明 |
---|---|
|
Bluetooth 無線が見つかりません。 |
|
pbtfrp パラメーターは NULL です。 |
|
pbtfrp が指す構造体が正しいサイズではありません。 |
|
メモリが不足しています。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む) |
Library | Bthprops.lib |
[DLL] | bthprops.cpl |