Funzione BluetoothSelectDevices (bluetoothapis.h)
La funzione BluetoothSelectDevices abilita la selezione del dispositivo Bluetooth.
Sintassi
BOOL BluetoothSelectDevices(
BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);
Parametri
pbtsdp
Puntatore a una struttura BLUETOOTH_SELECT_DEVICE_PARAMS che identifica i dispositivi Bluetooth.
Valore restituito
Restituisce TRUE se un utente ha selezionato un dispositivo.
Restituisce FALSE se non sono stati restituiti dati validi. Chiamare la funzione GetLastError per recuperare le informazioni sull'errore. Le condizioni seguenti si applicano alle informazioni sull'errore restituite.
| Codice restituito | Descrizione |
|---|---|
|
L'utente ha annullato la richiesta. |
|
Il parametro pbtsdp è NULL. |
|
La struttura passata in pbtsdp è di dimensioni sconosciute. |
Commenti
La funzione BluetoothSelectDevices apre una finestra di dialogo comune per la selezione dei dispositivi Bluetooth. L'elenco dei dispositivi visualizzati all'utente è determinato dai flag e dalle impostazioni specificati dal chiamante nel parametro pbtsdp .
Se BluetoothSelectDevices restituisceTRUE, il membro pDevices della struttura BLUETOOTH_SELECT_DEVICE_PARAMS punta a dati validi. Il chiamante deve verificare che i flag fAuthenticated e fRemembered nella struttura BLUETOOTH_SELECT_DEVICE_PARAMS per determinare quali dispositivi sono stati autenticati correttamente e quali dispositivi sono selezioni valide per l'utente. Chiamare la funzione BluetoothSelectDevicesFree per liberare risorse solo se la funzione BluetoothSelectDevices restituisce TRUE.
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 (include Bthsdpdef.h, BluetoothAPIs.h) |
| Libreria | Bthprops.lib |
| DLL | bthprops.cpl |