BluetoothAuthenticateMultipleDevices 関数 (bluetoothapis.h)

[アーティクル]
02/26/2024

BluetoothAuthenticateMultipleDevices 関数を使用すると、呼び出し元は Bluetooth 接続ウィザードの 1 つのインスタンスで複数のデバイスの認証を求められます。

注BluetoothAuthenticateMultipleDevices は非推奨になりました。この API の実装はお勧めしません。

構文

DWORD BluetoothAuthenticateMultipleDevices(
  HWND                  hwndParent,
  HANDLE                hRadio,
  DWORD                 cDevices,
  BLUETOOTH_DEVICE_INFO *rgbtdi
);

パラメーター

hwndParent

認証ウィザードの親となるウィンドウ。 NULL に設定すると、ウィザードはデスクトップから親になります。

hRadio

有効なローカル無線ハンドル、または NULL。 NULL の場合、すべてのローカル無線で認証が試行されます。無線が成功した場合、関数呼び出しは成功します。

cDevices

BLUETOOTH_DEVICE_INFO構造体の pbtdi 配列内のデバイスの数。

rgbtdi

認証される Bluetooth デバイスのレコードを含む BLUETOOTH_DEVICE_INFO 構造体の配列。

戻り値

正常に完了するとERROR_SUCCESSを返します。各デバイスの fAuthenticate フラグをチェックします。

次の表に、一般的なエラーの一覧を示します。

リターンコード	説明
ERROR_CANCELLED	ユーザーが操作を取り消しました。各 Bluetooth デバイスの fAuthenticate フラグを確認して、ユーザーが操作を取り消す前にデバイスが認証されたかどうかを確認します。
ERROR_INVALID_PARAMETER	pbtdi 配列内の 1 つ以上のデバイスが無効でした。
ERROR_NO_MORE_ITEMS	pbtdi が指すすべてのデバイスは、既に認証済みとしてマークされています。

要件

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