BluetoothFindNextDevice 函式 (bluetoothapis.h)

發行項
02/26/2024

BluetoothFindNextDevice 函式會尋找下一個藍牙裝置。

語法

BOOL BluetoothFindNextDevice(
  HBLUETOOTH_DEVICE_FIND hFind,
  BLUETOOTH_DEVICE_INFO  *pbtdi
);

參數

hFind

在先前呼叫 BluetoothFindFirstDevice 函式中取得的查詢句柄。

pbtdi

指向BLUETOOTH_DEVICE_INFO結構的指標，在其中放置下一個藍牙裝置的相關信息。 pbtdi 所指向之BLUETOOTH_DEVICE_INFO結構的 dwSize 成員必須符合結構的大小，否則 BluetoothFindNextDevice 的呼叫會失敗。

傳回值

成功找到下一個裝置時，會傳回 TRUE ，而 pbtdi 參數會指向裝置的相關信息。錯誤時傳回 FALSE 。如需錯誤的詳細資訊，請呼叫 GetLastError 函式。下表描述常見的錯誤：

傳回碼	Description
ERROR_INVALID_HANDLE	句柄為 NULL。
ERROR_NO_MORE_ITEMS	找不到更多裝置。
ERROR_OUTOFMEMORY	記憶體不足。

規格需求

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