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

Voir aussi

Bluetooth et getsockname

Bluetooth et BLOB

Bluetooth et WSASetService

WSAQUERYSET