BluetoothGetDeviceInfo 函式 (bluetoothapis.h)

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

語法

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

hRadio

本機無線電的句柄，從藍牙FindFirstRadio 或類似函式的呼叫，或從 對 SetupDiEnumerateDeviceInterfaces 函 式的呼叫取得。

pbtdi

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

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

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

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

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

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