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 関数を呼び出します。 次の表では、一般的なエラーについて説明します。

リターン コード 説明
ERROR_NO_MORE_ITEMS
 Bluetooth 無線が見つかりません。
ERROR_INVALID_PARAMETER
 pbtfrp パラメーターは NULL です。
ERROR_REVISION_MISMATCH
 pbtfrp が指す構造体が正しいサイズではありません。
ERROR_OUTOFMEMORY
 メモリが不足しています。

要件

要件 値
サポートされている最小のクライアント Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む)
Library Bthprops.lib
[DLL] bthprops.cpl

こちらもご覧ください

BLUETOOTH_FIND_RADIO_PARAMS

BluetoothFindNextRadio

BluetoothFindRadioClose

BluetoothGetRadioInfo

GetLastError