BluetoothRegisterForAuthentication 関数 (bluetoothapis.h)

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

BluetoothRegisterForAuthentication 関数は、特定の Bluetooth デバイスが認証を要求したときに呼び出されるコールバック関数を登録します。

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

構文

DWORD BluetoothRegisterForAuthentication(
  const BLUETOOTH_DEVICE_INFO            *pbtdi,
  HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandle,
  PFN_AUTHENTICATION_CALLBACK            pfnCallback,
  PVOID                                  pvParam
);

パラメーター

pbtdi

BLUETOOTH_DEVICE_INFO構造体へのポインター。 Address メンバーは比較に使用されます。

phRegHandle

登録 HANDLE が格納されている構造体へのポインター。 BluetoothUnregisterAuthentication を呼び出してハンドルを閉じます。

pfnCallback

認証イベントが発生したときに呼び出される関数。関数は、PFN_AUTHENTICATION_CALLBACKで説明されているプロトタイプと一致する必要があります。

pvParam

コールバック関数を介して渡される省略可能なパラメーター。

戻り値

正常に完了するとERROR_SUCCESSが返され、有効な登録ハンドルが phRegHandle で返されました。その他の戻り値は、エラーを示します。

エラーに関する詳細情報を取得するには、 GetLastError 関数を呼び出します。次の表では、一般的なエラーについて説明します。

リターンコード	説明
ERROR_OUTOFMEMORY	メモリが不足しています。

要件

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