共用方式為

BluetoothRegisterForAuthenticationEx 函式 (bluetoothapis.h)

  • 發行項

BluetoothRegisterForAuthenticationEx 函式會針對針腳要求、數值比較和回呼函式註冊應用程式。

注意 Windows Vista SP2 和 Windows 7 支援此 API。
 

語法

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_DEVICE_INFO 結構的指標，指定要用於比較的藍牙位址。

[out] phRegHandleOut

與已註冊應用程式相關聯 之HBLUETOOTH_AUTHENTICATION_REGISTRATION 句柄的指標。 呼叫 BluetoothUnregisterAuthentication 以關閉句柄。

[in, optional] pfnCallbackIn

在驗證事件發生時所呼叫的函式。 此函式應符合 PFN_AUTHENTICATION_CALLBACK_EX的原型。

[in, optional] pvParam

要傳遞至 pfnCallbackIn 所指定回呼函式的選擇性參數。 這個參數可以是應用程式定義所需的任何專案。

傳回值

成功完成時傳回ERROR_SUCCESS;失敗時會傳回下列錯誤碼：

傳回碼 Description
ERROR_OUTOFMEMORY
 記憶體不足。
Win32 錯誤
 提供的註冊句柄無效。

備註

呼叫端必須提供有效的回呼位址，而且一旦不再需要通知，就必須取消註冊回呼。 您可以藉由呼叫 BluetoothUnregisterAuthentication 來完成已驗證裝置的取消註冊。

在應用程式註冊驗證多次的情況下，在進行驗證時，只會在應用程式中呼叫透過此函式註冊的第一個回呼函式。

規格需求

需求 值
最低支援的用戶端 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h)
程式庫 Bthprops.lib
Dll bthprops.cpl

另請參閱

BluetoothRegisterForAuthentication

BluetoothUnregisterAuthentication