bluetoothEnableDiscovery 函式 (bluetoothapis.h)
BluetoothEnableDiscovery 函式會變更本機藍牙無線電或無線電的探索狀態。
語法
BOOL BluetoothEnableDiscovery(
HANDLE hRadio,
BOOL fEnabled
);
參數
hRadio
有效的本機無線電句柄或 NULL。 如果 為 NULL,則會在所有本機無線電上修改探索;如果呼叫修改任何無線電,則函式呼叫會成功。
fEnabled
指定要啟用或停用探索的旗標。 設定為 TRUE 以啟用探索,將 設定為 FALSE 以停用探索。
傳回值
如果探索狀態已成功變更,則傳回 TRUE 。 如果 hRadio 是 NULL, 則 TRUE 的傳回值表示已成功變更一個本機無線電狀態。 如果探索狀態未變更,則傳回 FALSE ;如果 hRadio 是 NULL,則沒有任何無線電接受狀態變更。
備註
使用 BluetoothIsDiscoverable 函式 來判斷藍牙無線電的目前狀態。 Windows 可確保可探索的系統可連線,因此,無線電必須允許連入連線,才能讓無線電可探索。 無法允許連入聯機會導致 BluetoothEnableDiscovery 函式 呼叫失敗。
當 BluetoothEnableDiscovery 變更探索狀態時,新狀態對於呼叫應用程式的存留期有效。 此外,如果先前使用此函式進行可探索的藍牙無線電已停用,並透過應用程式重新啟用,則可探索性將不會保存。 呼叫端應用程式終止之後,所指定藍牙無線電的探索狀態會還原為呼叫 BluetoothEnableDiscovery 之前所在的狀態。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h) |
程式庫 | Bthprops.lib |
Dll | bthprops.cpl |
另請參閱
BluetoothAuthenticateMultipleDevices
BluetoothEnableIncomingConnections
BluetoothRegisterForAuthentication