SOCKADDR_BTH struttura (ws2bth.h)

La struttura SOCKADDR_BTH viene usata insieme alle operazioni del socket Bluetooth, definite dalla famiglia di indirizzi AF_BTH .

Sintassi

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

Members

addressFamily

Famiglia di indirizzi del socket. Questo membro è sempre AF_BTH.

btAddr

Indirizzo del dispositivo Bluetooth di destinazione. Se usato con la funzione di associazione , deve essere zero o un indirizzo radio locale valido. Se zero, viene assegnato un indirizzo di dispositivo Bluetooth locale valido quando viene chiamata la funzione di connessione o accettazione . Se usato con la funzione di connessione , è necessario specificare un indirizzo radio remoto valido.

serviceClassId

Identificatore della classe di servizio del socket. Se usato con la funzione di associazione , serviceClassId viene ignorato. Ignorato anche se viene specificata la porta. Per la funzione di connessione , specifica l'ID della classe di servizio Bluetooth univoca del servizio a cui vuole connettersi. Se il dispositivo peer ha più di una porta corrispondente all'identificatore della classe di servizio, la funzione di connessione tenta di connettersi al primo servizio valido; questo meccanismo può essere usato senza query SDP precedenti.

port

Canale RFCOMM associato al socket. Vedere la sezione Osservazioni.

Commenti

Quando viene usata con la funzione di associazione nelle applicazioni client, il membro della porta deve essere zero per consentire l'assegnazione di un endpoint locale appropriato. Se usato con binding nelle applicazioni server, il membro della porta deve essere un numero di porta valido o BT_PORT_ANY; le porte assegnate automaticamente usando BT_PORT_ANY possono essere sottoposte a query successivamente con una chiamata alla funzione getsockname . L'intervallo valido per la richiesta di una porta RFCOMM specifica è compreso tra 1 e 30.

Quando si usa la funzione di connessione quando serviceClassId non viene fornito, la porta deve specificare direttamente il numero di porta remota a cui viene richiesta un'operazione di connessione . L'uso del membro della porta anziché del membro serviceClassId richiede all'applicazione di eseguire la ricerca del proprio servizio (SDP) prima di tentare l'operazione di connessione .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato Nessuno supportato
Intestazione ws2bth.h

Vedi anche

Bluetooth e associazione

Bluetooth e getsockname

Bluetooth e accettare

Bluetooth e connessione