共用方式為

BluetoothSelectDevices 函式 (bluetoothapis.h)

  • 發行項

BluetoothSelectDevices 函式會啟用藍牙裝置選取。

語法

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

參數

pbtsdp

識別藍牙裝置 之BLUETOOTH_SELECT_DEVICE_PARAMS 結構的指標。

傳回值

如果用戶選取了裝置，則會傳回 TRUE 。

如果沒有傳回有效的數據，則傳回 FALSE 。 呼叫 GetLastError 函式以擷取錯誤資訊。 下列條件適用於傳回的錯誤資訊。

傳回碼 Description
ERROR_CANCELLED
 使用者已取消要求。
ERROR_INVALID_PARAMETER
 pbtsdp 參數為 NULL。
ERROR_REVISION_MISMATCH
 傳入 pbtsdp 的結構大小不明。

備註

BluetoothSelectDevices 函式會開啟用於選取藍牙裝置的一般對話方塊。 向用戶顯示的裝置清單取決於呼叫端在 pbtsdp 參數中指定的旗標和設定。

如果 BluetoothSelectDevices 傳回 TRUE，BLUETOOTH_SELECT_DEVICE_PARAMS結構的 pDevices 成員會指向有效的數據。 呼叫端應該確認BLUETOOTH_SELECT_DEVICE_PARAMS結構中的 fAuthenticated 和 fRemembered 旗標，以判斷哪些裝置已成功驗證，以及哪些裝置是使用者的有效選擇。 只有在 BluetoothSelectDevices 函式傳回 TRUE 時，才呼叫 BluetoothSelectDevicesFree 函式來釋放資源。

規格需求

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

另請參閱

BLUETOOTH_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK