structure SOCKADDR_BTH (ws2bth.h)

La structure SOCKADDR_BTH est utilisée conjointement avec les opérations de socket Bluetooth, définies par les AF_BTH de famille d’adresses.

Syntaxe

typedef struct _SOCKADDR_BTH {
  USHORT   addressFamily;
  BTH_ADDR btAddr;
  GUID     serviceClassId;
  ULONG    port;
} SOCKADDR_BTH, *PSOCKADDR_BTH;

Membres

addressFamily

Famille d’adresses du socket. Ce membre est toujours AF_BTH.

btAddr

Adresse de l’appareil Bluetooth cible. En cas d’utilisation avec la fonction de liaison , doit être égal à zéro ou à une adresse radio locale valide. Si zéro, une adresse d’appareil Bluetooth locale valide est attribuée lorsque la fonction de connexion ou d’acceptation est appelée. Lorsqu’elle est utilisée avec la fonction connect , une adresse radio distante valide doit être spécifiée.

serviceClassId

Identificateur de classe de service du socket. Lorsqu’il est utilisé avec la fonction de liaison , serviceClassId est ignoré. Également ignoré si le port est spécifié. Pour la fonction de connexion , spécifie l’ID de classe de service Bluetooth unique du service auquel elle souhaite se connecter. Si l’appareil homologue a plusieurs ports qui correspondent à l’identificateur de classe de service, la fonction de connexion tente de se connecter au premier service valide ; ce mécanisme peut être utilisé sans requêtes SDP préalables.

port

Canal RFCOMM associé au socket. Consultez la section Notes.

Remarques

Lorsqu’il est utilisé avec la fonction de liaison sur les applications clientes, le membre de port doit être égal à zéro pour permettre l’attribution d’un point de terminaison local approprié. Lorsqu’il est utilisé avec bind sur les applications serveur, le membre de port doit être un numéro de port ou un BT_PORT_ANY valide ; les ports attribués automatiquement à l’aide de BT_PORT_ANY peuvent être interrogés ultérieurement avec un appel à la fonction getsockname . La plage valide pour demander un port RFCOMM spécifique est comprise entre 1 et 30.

Lorsque vous utilisez la fonction connect quand serviceClassId n’est pas fourni, le port doit spécifier directement le numéro de port distant auquel une opération de connexion est demandée. L’utilisation du membre de port au lieu du membre serviceClassId nécessite que l’application effectue sa propre recherche de service (SDP) avant de tenter l’opération de connexion .

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 liaison

Bluetooth et getsockname

Bluetooth et accepter

Bluetooth et connexion