BluetoothSendAuthenticationResponse 関数 (bluetoothapis.h)

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

BluetoothSendAuthenticationResponse 関数は、パスキー応答を送信する認証要求を受信したときに呼び出されます。

メモ Windows Vista SP2 および Windows 7 用に開発する場合は、 BluetoothSendAuthenticationResponseEx を使用することをお勧めします。

構文

DWORD BluetoothSendAuthenticationResponse(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  LPCWSTR                     pszPasskey
);

パラメーター

hRadio

ローカル無線ハンドルへの省略可能なハンドル、または NULL。 NULL の場合、関数はすべてのローカル無線で認証応答の送信を試みます。

pbtdi

認証される Bluetooth デバイスを記述する BLUETOOTH_DEVICE_INFO 構造体へのポインター。これは、コールバック関数に渡されるのと同じ構造にすることができます。

pszPasskey

認証デバイスに送り返されるパスキー応答の UNICODE 0 で終わる文字列へのポインター。 pszPasskey パラメーターは、null を除き、BLUETOOTH_MAX_PASSKEY_SIZE以下にできます。 ANSI への変換が実行される場合、 pszPasskey パラメーターは NULL を除いて 16 バイトを超えることはできません。

戻り値

デバイスがパスキー応答を受け入れたときにERROR_SUCCESSを返します。デバイスが認証されます。その他の戻り値は、エラーを示します。次の表では、一般的なエラーについて説明します。

リターンコード	説明
ERROR_CANCELLED	Bluetooth デバイスがパスキーの応答を拒否しました。このエラーは、ローカル無線で通信の問題が発生した場合にも返されます。
E_FAIL	認証中にデバイスからエラーコードが返されました。

要件

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