bluetoothEnableDiscovery 函式 (bluetoothapis.h)

發行項
02/26/2024

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