BTH_SET_SERVICE structure (ws2bth.h)
La structure BTH_SET_SERVICE fournit des informations de service pour le service Bluetooth spécifié.
Syntaxe
typedef struct _BTH_SET_SERVICE {
PULONG pSdpVersion;
HANDLE *pRecordHandle;
ULONG fCodService;
ULONG Reserved[5];
ULONG ulRecordLength;
UCHAR pRecord[1];
} BTH_SET_SERVICE, *PBTH_SET_SERVICE, BTHNS_SETBLOB, *PBTHNS_SETBLOB;
Membres
pSdpVersion
Version du SDP. Les clients définissent ce membre sur BTH_SDP_VERSION.
pRecordHandle
Gérez l’enregistrement SDP. Correspond à SDP ServiceRecordHandle. Retourné par les opérations d’ajout d’enregistrement, puis utilisé pour supprimer l’enregistrement.
fCodService
Informations sur la classe d’appareil (COD). Champ 32 bits de la classe COD_SERVICE_* des bits d’appareil associés à cet enregistrement SDP. Le système combine ces bits avec des bits COD provenant d’autres enregistrements de service et caractéristiques système. La classe d’appareil obtenue pour la radio locale est annoncée lorsque la radio est trouvée lors de la recherche de l’appareil. Lorsque le dernier enregistrement SDP associé à un bit de service particulier est supprimé, ce bit de service n’est plus signalé dans les réponses aux demandes d’appareil futures.
Le format et les valeurs possibles du champ COD sont définis dans la partie Bluetooth Assigned Numbers 1.1 de la spécification Bluetooth, Section 1.2. (Cette ressource n’est peut-être pas disponible dans certaines langues et certains pays.) Les macros et définitions correspondantes pour les bits COD_SERVICE_* utilisés par Windows sont définies dans Bthdef.h. Pour plus d’informations sur la classe d’appareil (COD), consultez BTH_DEVICE_INFO.
Reserved[5]
Réservé. Doit être défini sur zéro.
ulRecordLength
Taille, en octets, de pRecord.
pRecord[1]
Enregistrement SDP, tel que défini par la spécification Bluetooth.
Remarques
Lors de l’utilisation de la structure BTH_SET_SERVICE pour interroger des services et des appareils à l’aide de la fonction WSASetService et des structures WSAQUERYSET et BLOB . Les valeurs suivantes pour BTH_SET_SERVICE membres doivent être utilisées.
Pour plus d’informations sur la classe d’appareil (COD), consultez la spécification Bluetooth à www.bluetooth.com.
| Membre | Valeur requise |
|---|---|
| pSdpVersion | Pointeur vers la version ULONG, qui est modifiée chaque fois que le format binaire des enregistrements SDP change, affectant le format du membre pRecord . Défini sur BTH_SDP_VERSION pour le client et retourné par le système. |
| pRecordHandle | Gérer l’enregistrement SDP ; correspond à SDP ServiceRecordHandle. Retourné par les opérations d’ajout d’enregistrement, puis utilisé pour supprimer l’enregistrement. |
| fOptions | Attributs définis par BTHNS_SET_FLAGS. |
| ulRecordLength | Longueur, en octets, de l’enregistrement SDP binaire pointé par pRecord. |
| pRecord | Pointeur vers un enregistrement SDP valide, au format défini par la spécification Bluetooth. |
Le membre pRecordHandle doit pointer vers des données null pour la nouvelle inscription de service. Pour la suppression du service, pRecordHandle doit pointer vers un handle valide. Le membre pRecord doit contenir l’enregistrement de service SD entier, comme décrit dans la spécification Bluetooth. Pour les entrées de protocole RFCOMM, le numéro de port est le même que le port retourné par l’appel de fonction getsockname .
Bluetooth implémente une corrélation un-à-un entre les enregistrements SDP et les sockets de serveur. Par conséquent, il n’est pas nécessaire d’utiliser l’indicateur SERVICE_MULTIPLE .
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 | ws2bth.h |