BluetoothSelectDevices 函式 (bluetoothapis.h)
BluetoothSelectDevices 函式會啟用藍牙裝置選取。
語法
BOOL BluetoothSelectDevices(
BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);
參數
pbtsdp
識別藍牙裝置 之BLUETOOTH_SELECT_DEVICE_PARAMS 結構的指標。
傳回值
如果用戶選取了裝置，則會傳回 TRUE 。
如果沒有傳回有效的數據，則傳回 FALSE 。 呼叫 GetLastError 函式以擷取錯誤資訊。 下列條件適用於傳回的錯誤資訊。
| 傳回碼 | Description |
|---|---|
|
使用者已取消要求。 |
|
pbtsdp 參數為 NULL。 |
|
傳入 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 |