BluetoothSelectDevices 関数 (bluetoothapis.h)

  • [アーティクル]

BluetoothSelectDevices 関数を使用すると、Bluetooth デバイスを選択できます。

構文

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

パラメーター

pbtsdp

Bluetooth デバイスを識別する BLUETOOTH_SELECT_DEVICE_PARAMS 構造体へのポインター。

戻り値

ユーザーがデバイスを選択した場合は TRUE を 返します。

有効なデータが返されなかった場合は FALSE を 返します。 エラー情報を取得するには 、GetLastError 関数を呼び出します。 返されたエラー情報には、次の条件が適用されます。

リターン コード 説明
ERROR_CANCELLED
 ユーザーが要求を取り消しました。
ERROR_INVALID_PARAMETER
 pbtsdp パラメーターは NULL です。
ERROR_REVISION_MISMATCH
 pbtsdp で渡される構造体のサイズは不明です。

注釈

BluetoothSelectDevices 関数を使用すると、Bluetooth デバイスを選択するための一般的なダイアログ ボックスが開きます。 ユーザーに表示されるデバイスの一覧は、呼び出し元が pbtsdp パラメーターで指定するフラグと設定によって決まります。

BluetoothSelectDevices が TRUE を返す場合、BLUETOOTH_SELECT_DEVICE_PARAMS構造体の pDevices メンバーは有効なデータを指します。 呼び出し元は、BLUETOOTH_SELECT_DEVICE_PARAMS構造の fAuthenticated フラグと fRemembered フラグを確認して、正常に認証されたデバイスと、ユーザーに対して有効な選択であるデバイスを確認する必要があります。 BluetoothSelectDevicesFree 関数を呼び出して、BluetoothSelectDevices 関数が TRUE を返す場合にのみリソースを解放します。

要件

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

こちらもご覧ください

BLUETOOTH_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK