estructura BLUETOOTH_SELECT_DEVICE_PARAMS (bluetoothapis.h)
La estructura de BLUETOOTH_SELECT_DEVICE_PARAMS facilita y administra la visibilidad, la autenticación y la selección de dispositivos y servicios Bluetooth.
Sintaxis
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;
Miembros
dwSize
Tamaño, en bytes, de la estructura BLUETOOTH_SELECT_DEVICE_PARAMS .
cNumOfClasses
Número de clases en prgClassOfDevices. Establezca en cero para buscar todos los dispositivos.
prgClassOfDevices
Matriz de la clase de dispositivos que se van a buscar.
pszInfo
Establece el texto de información cuando no es NULL.
hwndParent
Identificador de la ventana primaria. Establezca en NULL para ningún elemento primario.
fForceAuthentication
Si es TRUE, fuerza la autenticación antes de devolverla.
fShowAuthenticated
Si es TRUE, los dispositivos autenticados se muestran en el selector.
fShowRemembered
Si es TRUE, los dispositivos recordados se muestran en el selector.
fShowUnknown
Si es TRUE, los dispositivos desconocidos que no están autenticados o recordados se muestran en el selector.
fAddNewDeviceWizard
Si es TRUE, inicia el Asistente para agregar nuevo dispositivo.
fSkipServicesPage
Si es TRUE, omite la página Servicios en el Asistente para agregar nuevo dispositivo.
pfnDeviceCallback
Puntero a una función de devolución de llamada a la que se llama para cada dispositivo. Si la función de devolución de llamada devuelve TRUE, se agrega el elemento. Si la función de devolución de llamada devuelve FALSE, no se muestra el elemento. Establezca pfnDeviceCallback en NULL para ninguna devolución de llamada. Para obtener más información, consulte PFN_DEVICE_CALLBACK.
pvParam
Parámetro que se va a pasar como pvParam a la función de devolución de llamada a la que apunta en pfnDeviceCallback.
cNumDevices
En la entrada, especifica el número de llamadas deseadas. Se establece en cero para ningún límite. En la salida, devuelve el número de dispositivos devueltos.
pDevices
Puntero a una matriz de estructuras de BLUETOOTH_DEVICE_INFO .
Comentarios
Para liberar la matriz de BLUETOOTH_DEVICE_INFO estructuras pasadas en el miembro pDevices , llame a la función BluetoothSelectDevicesFree .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Encabezado | bluetoothapis.h (incluya Bthsdpdef.h, BluetoothAPIs.h) |