BluetoothRegisterForAuthenticationEx 関数 (bluetoothapis.h)

  • [アーティクル]

BluetoothRegisterForAuthenticationEx 関数は、ピン要求、数値比較、コールバック関数のアプリケーションを登録します。

メモ この API は、Windows Vista SP2 と Windows 7 でサポートされています。
 

構文

DWORD BluetoothRegisterForAuthenticationEx(
  [in, optional] const BLUETOOTH_DEVICE_INFO            *pbtdiIn,
  [out]          HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandleOut,
  [in, optional] PFN_AUTHENTICATION_CALLBACK_EX         pfnCallbackIn,
  [in, optional] PVOID                                  pvParam
);

パラメーター

[in, optional] pbtdiIn

比較に使用する bluetooth アドレスを指定する BLUETOOTH_DEVICE_INFO 構造体へのポインター。

[out] phRegHandleOut

登録済みアプリケーションに関連付けられている HBLUETOOTH_AUTHENTICATION_REGISTRATION ハンドルへのポインター。 BluetoothUnregisterAuthentication を呼び出してハンドルを閉じます。

[in, optional] pfnCallbackIn

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

[in, optional] pvParam

pfnCallbackIn によって指定されたコールバック関数に渡される省略可能なパラメーター。 このパラメーターには、アプリケーションが定義するために必要なものは何でも指定できます。

戻り値

正常に完了したときにERROR_SUCCESSを返します。は、エラー発生時に次のエラー コードを返します。

リターン コード 説明
ERROR_OUTOFMEMORY
 メモリが不足しています。
Win32 エラー
 指定された登録ハンドルが無効です。

注釈

呼び出し元は有効なコールバック アドレスを指定する必要があり、通知が不要になったらコールバックの登録を解除する必要があります。 認証されたデバイスの登録解除は、 BluetoothUnregisterAuthentication を呼び出すことによって実現できます。

アプリケーションが認証に複数回登録されるシナリオでは、認証の進行中に、この関数を介して登録された最初のコールバック関数のみがアプリケーションで呼び出されます。

要件

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

こちらもご覧ください

BluetoothRegisterForAuthentication

BluetoothUnregisterAuthentication