BluetoothGetDeviceInfo 函式（bluetoothapis.h）

BluetoothGetDeviceInfo 函式會擷取遠端藍牙裝置的相關信息。藍牙裝置先前必須透過成功的裝置查詢函式呼叫來識別。

語法

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

hRadio

本機無線電的句柄，從呼叫 BluetoothFindFirstRadio 或類似函式，或從呼叫 SetupDiEnumDeviceInterfaces 函式取得。

pbtdi

要放置第一個藍牙裝置相關數據的 BLUETOOTH_DEVICE_INFO 結構的指標。如需詳細資訊，請參閱。

成功時傳回 ERROR_SUCCESS，指出已擷取遠端藍牙裝置的相關數據。傳回失敗時的錯誤碼。下表列出與 BluetoothGetDeviceInfo 函式相關聯的常見錯誤碼。

傳回碼	描述
ERROR_REVISION_MISMATCH	BLUETOOTH_DEVICE_INFO的大小不相容。檢查 BLUETOOTH_DEVICE_INFO 結構的 dwSize 成員。
ERROR_NOT_FOUND	系統不知道無線電，或 BLUETOOTH_DEVICE_INFO 結構地址成員都是零。
ERROR_INVALID_PARAMETER	pbtdi 參數 NULL。

取得數據的藍牙裝置之前必須透過成功的裝置查詢函式呼叫來識別。

在 pbtdi所指向的 BLUETOOTH_DEVICE_INFO 結構中，dwSize 成員必須相當於結構的大小，以位元組為單位。 BLUETOOTH_DEVICE_INFO 結構位址成員必須包含遠端裝置的藍牙位址。

要求	價值
最低支援的用戶端	Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
支援的最低伺服器	不支援
目標平臺	窗戶
標頭	bluetoothapis.h （include Bthsdpdef.h， BluetoothAPIs.h）
連結庫	Bthprops.lib
DLL	bthprops.cpl