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

另請參閱

BLUETOOTH_DEVICE_INFO

BLUETOOTH_DEVICE_SEARCH_PARAMS

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

BluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothRemoveDevice