struttura BLUETOOTH_SELECT_DEVICE_PARAMS (bluetoothapis.h)
La struttura BLUETOOTH_SELECT_DEVICE_PARAMS facilita e gestisce la visibilità, l'autenticazione e la selezione di dispositivi e servizi Bluetooth.
Sintassi
typedef struct _BLUETOOTH_SELECT_DEVICE_PARAMS {
DWORD dwSize;
ULONG cNumOfClasses;
BLUETOOTH_COD_PAIRS *prgClassOfDevices;
LPWSTR pszInfo;
HWND hwndParent;
BOOL fForceAuthentication;
BOOL fShowAuthenticated;
BOOL fShowRemembered;
BOOL fShowUnknown;
BOOL fAddNewDeviceWizard;
BOOL fSkipServicesPage;
PFN_DEVICE_CALLBACK pfnDeviceCallback;
LPVOID pvParam;
DWORD cNumDevices;
PBLUETOOTH_DEVICE_INFO pDevices;
} BLUETOOTH_SELECT_DEVICE_PARAMS;
Members
dwSize
Dimensioni, in byte, della struttura BLUETOOTH_SELECT_DEVICE_PARAMS .
cNumOfClasses
Numero di classi in prgClassOfDevices. Impostare su zero per cercare tutti i dispositivi.
prgClassOfDevices
Matrice di classi di dispositivi da trovare.
pszInfo
Imposta il testo delle informazioni quando non è NULL.
hwndParent
Handle per la finestra padre. Impostare su NULL per nessun elemento padre.
fForceAuthentication
Se TRUE, forza l'autenticazione prima della restituzione.
fShowAuthenticated
Se TRUE, i dispositivi autenticati vengono visualizzati nella selezione.
fShowRemembered
Se TRUE, i dispositivi memorizzati vengono visualizzati nella selezione.
fShowUnknown
Se TRUE, i dispositivi sconosciuti non autenticati o memorizzati vengono visualizzati nella selezione.
fAddNewDeviceWizard
Se TRUE, avvia la procedura guidata Aggiungi nuovo dispositivo.
fSkipServicesPage
Se TRUE, ignora la pagina Servizi nella procedura guidata Aggiungi nuovo dispositivo.
pfnDeviceCallback
Puntatore a una funzione di callback chiamata per ogni dispositivo. Se la funzione di callback restituisce TRUE, viene aggiunto l'elemento. Se la funzione di callback restituisce FALSE, l'elemento non viene visualizzato. Impostare pfnDeviceCallback su null per nessun callback. Per altre informazioni, vedere PFN_DEVICE_CALLBACK.
pvParam
Parametro da passare come pvParam alla funzione di callback a cui punta in pfnDeviceCallback.
cNumDevices
In input specifica il numero di chiamate desiderate. Impostare su zero per nessun limite. Nell'output restituisce il numero di dispositivi restituiti.
pDevices
Puntatore a una matrice di strutture BLUETOOTH_DEVICE_INFO .
Commenti
Per liberare la matrice di BLUETOOTH_DEVICE_INFO strutture passate nel membro pDevices , chiamare la funzione BluetoothSelectDevicesFree .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista, Windows XP con SP2 [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Intestazione | bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h) |