Funzione BluetoothEnableDiscovery (bluetoothapis.h)

Articolo
08/22/2023

La funzione BluetoothEnableDiscovery modifica lo stato di individuazione di una radio o radio Bluetooth locale.

Sintassi

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

Parametri

hRadio

Handle di radio locale valido o NULL. Se NULL, l'individuazione viene modificata in tutte le radio locali; se qualsiasi radio viene modificata dalla chiamata, la chiamata alla funzione ha esito positivo.

fEnabled

Contrassegno che specifica se l'individuazione deve essere abilitata o disabilitata. Impostare su TRUE per abilitare l'individuazione, impostare su FALSE per disabilitare l'individuazione.

Valore restituito

Restituisce TRUE se lo stato di individuazione è stato modificato correttamente. Se hRadio è NULL, un valore restituito di TRUE indica che almeno uno stato radio locale è stato modificato correttamente. Restituisce FALSE se lo stato di individuazione non è stato modificato; se hRadio era NULL, nessuna radio accettava la modifica dello stato.

Commenti

Usare la funzione BluetoothIsDiscoverable per determinare lo stato corrente di una radio Bluetooth. Windows garantisce che un sistema individuabile sia connettibile e, di conseguenza, la radio deve consentire connessioni in ingresso prima di rendere individuabile una radio. Non è possibile consentire connessioni in ingresso, la chiamata alla funzione BluetoothEnableDiscovery ha esito negativo.

Quando BluetoothEnableDiscovery modifica lo stato di individuazione, il nuovo stato è valido per la durata dell'applicazione chiamante. Inoltre, se una radio Bluetooth precedentemente resa individuabile con questa funzione è disabilitata e abilitata nuovamente tramite l'applicazione, la individuabilità non persiste. Una volta terminata l'applicazione chiamante, lo stato di individuazione della radio Bluetooth specificato viene ripristinato allo stato in cui è stato chiamato BluetoothEnableDiscovery .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	bluetoothapis.h (includere Bthsdpdef.h, BluetoothAPIs.h)
Libreria	Bthprops.lib
DLL	bthprops.cpl