Partager via


Bluetooth et WSAQUERYSET pour l’enquête sur les services

Bluetooth utilise la structureWSAQUERYSET, avec diverses fonctions, pour faciliter la découverte d’appareils et de services dans l’espace de noms Bluetooth, NS_BTH.

Les fonctions WSALookupServiceBegin et WSALookupServiceNext utilisent la structure WSAQUERYSET pour obtenir des données sur le processus d’enquête de service. Le tableau suivant décrit comment définir les valeurs de membre dans la structure WSAQUERYSET à cet effet.

Membre Entrée dans WSALookupServiceBegin Valeur retournée à partir de WSALookupServiceNext
dwSize Doit être défini sur taille de(WSAQUERYSET). sizeof(WSAQUERYSET) retourné par le système.
dwOutputFlags Non utilisé. Non utilisé.
lpszServiceInstanceName Non utilisé. Nom complet du service, converti en tant que chaîne encodée UTF-8 à partir de l’encodage de langue par défaut de l’attribut SDP Bluetooth ServiceName. Retourné si LUP_RETURN_NAME est spécifié.
lpServiceClassId Obligatoire. L’UUID Bluetooth le plus spécifique pour les services pour lesquels la recherche est effectuée. Par exemple, si cette valeur est définie sur l’UUID du protocole L2CAP, elle retourne tous les services à l’aide du protocole L2CAP sur l’appareil cible. S’il est défini sur l’UUID d’un service spécifique, il retourne uniquement les instances de ce service. Non utilisé.
lpVersion Non utilisé. Non utilisé.
lpszComment Non utilisé. Description du service, convertie en tant que chaîne encodée UTF-8 à partir de l’encodage de langue par défaut de l’attribut SDP Bluetooth ServiceDescription. Retourné si LUP_RETURN_COMMENT est spécifié.
dwNameSpace Doit être NS_BTH. Retourne NS_BTH.
lpNSProviderId Non utilisé. Non utilisé.
lpszContext Obligatoire. Adresse de l’appareil Bluetooth avec laquelle établir une connexion SDP et rechercher des services. Cette valeur doit être une chaîne qui a été convertie à l’aide de l’appel de fonction WSAAddressToStr ing. Si l’adresse de l’appareil Bluetooth local est fournie, la base de données SDP locale est recherchée. Non utilisé.
dwNumberOfProtocols Non utilisé. Non utilisé.
lpafpProtocols Non utilisé. Non utilisé.
lpszQueryString Non utilisé. Non utilisé.
dwNumberOfCsAddrs Non utilisé. Indique le nombre d’éléments dans le tableau de structures CSADDR_INFO.
lpcsaBuffer Non utilisé. Pointeur vers une structure CSADDR_INFO dont LocalAddr.lpSockaddr membre pointe vers un SOCKADDR_BTH qui contient l’adresse connectable complète du service distant, convertie à partir de la première entrée de l’attribut SDP ProtocolDescriptorList Bluetooth. Retourné si LUP_RETURN_ADDR est spécifié.
lpBlob Optionnel. Pointeur vers une structure BTH_QUERY_SERVICE qui contient des paramètres avancés pour limiter les résultats de la recherche. Si elle est fournie, lpServiceClassId est ignorée et les requêtes mises en cache ne réussissent pas.
  • Si une recherche de service est effectuée : pointeur vers une structure BLOB qui retourne les handles de service. (BLOB.cbSize)/sizeof(ULONG) calcule le nombre de handles. blob.pBlobData est un tableau de valeurs ULONG représentant les handles de service.
  • Si une recherche d’attribut ou de serviceAttribute est effectuée : pointeur vers une structure BLOB qui retourne l’enregistrement SDP binaire. BLOB.cbSize est la taille de l’enregistrement SDP binaire. BLOB.pBlobData pointe vers l’enregistrement lui-même. L’enregistrement SDP binaire est nécessaire dans de nombreux cas, car seul un nombre limité d’attributs SDP peuvent être convertis en structure WSAQUERYSET, et seules les chaînes UTF-8 codées par défaut sont converties. Les fonctions permettant d’analyser l’enregistrement SDP binaire sont fournies dans la section Référence Bluetooth.
  • Retourné si LUP_RETURN_BLOB est spécifié.

 

Bluetooth et WSAQUERYSET pour set Service

Bluetooth et WSAQUERYSET pour l’enquête sur les appareils

Bluetooth et BLOB

Bluetooth et WSALookupServiceBegin

Bluetooth et WSALookupServiceNext

de référence Bluetooth

BLOB

BTH_QUERY_SERVICE

CSADDR_INFO

SOCKADDR_BTH

WSAAddressToString

WSAQUERYSET

windows Sockets