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 |