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)

Vedi anche

BLUETOOTH_COD_PAIRS

BLUETOOTH_DEVICE_INFO

BluetoothSelectDevices

BluetoothSelectDevicesFree

PFN_DEVICE_CALLBACK