structure BLUETOOTH_SELECT_DEVICE_PARAMS (bluetoothapis.h)
La structure BLUETOOTH_SELECT_DEVICE_PARAMS facilite et gère la visibilité, l’authentification et la sélection des appareils et services Bluetooth.
Syntaxe
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;
Membres
dwSize
Taille, en octets, de la structure BLUETOOTH_SELECT_DEVICE_PARAMS .
cNumOfClasses
Nombre de classes dans prgClassOfDevices. Définissez sur zéro pour rechercher tous les appareils.
prgClassOfDevices
Tableau de la classe d’appareils à rechercher.
pszInfo
Définit le texte d’informations lorsqu’il n’est pas NULL.
hwndParent
Handle vers la fenêtre parente. Définissez sur NULL pour aucun parent.
fForceAuthentication
Si la valeur EST TRUE, force l’authentification avant le retour.
fShowAuthenticated
Si la valeur EST TRUE, les appareils authentifiés s’affichent dans le sélecteur.
fShowRemembered
Si la valeur EST TRUE, les appareils mémorisés sont affichés dans le sélecteur.
fShowUnknown
Si la valeur est TRUE, les appareils inconnus qui ne sont pas authentifiés ou mémorisés sont affichés dans le sélecteur.
fAddNewDeviceWizard
Si la valeur est TRUE, démarre l’Assistant Ajouter un nouvel appareil.
fSkipServicesPage
Si la valeur est TRUE, ignore la page Services dans l’Assistant Ajouter un nouvel appareil.
pfnDeviceCallback
Pointeur vers une fonction de rappel appelée pour chaque appareil. Si la fonction de rappel retourne TRUE, l’élément est ajouté. Si la fonction de rappel retourne FALSE, l’élément n’est pas affiché. Définissez pfnDeviceCallback sur null pour aucun rappel. Pour plus d’informations, consultez PFN_DEVICE_CALLBACK.
pvParam
Paramètre à passer en tant que pvParam à la fonction de rappel pointée dans pfnDeviceCallback.
cNumDevices
En entrée, spécifie le nombre d’appels souhaités. Définissez sur zéro pour aucune limite. À la sortie, retourne le nombre d’appareils retournés.
pDevices
Pointeur vers un tableau de structures BLUETOOTH_DEVICE_INFO .
Remarques
Pour libérer le tableau de structures BLUETOOTH_DEVICE_INFO passées dans le membre pDevices , appelez la fonction BluetoothSelectDevicesFree .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| En-tête | bluetoothapis.h (inclure Bthsdpdef.h, BluetoothAPIs.h) |