SOCKADDR_BTH-Struktur (ws2bth.h)

Die SOCKADDR_BTH-Struktur wird in Verbindung mit Bluetooth-Socketvorgängen verwendet, die durch Adressfamilien AF_BTH definiert werden.

Syntax

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

Member

addressFamily

Adressfamilie des Sockets. Dieses Element ist immer AF_BTH.

btAddr

Adresse des Bluetooth-Zielgeräts. Bei Verwendung mit der Bindungsfunktion muss null oder eine gültige lokale Funkadresse sein. Wenn null ist, wird eine gültige lokale Bluetooth-Geräteadresse zugewiesen, wenn die Verbindungs- oder Annahmefunktion aufgerufen wird. Bei Verwendung mit der Verbindungsfunktion muss eine gültige Remotefunkadresse angegeben werden.

serviceClassId

Dienstklassenbezeichner des Sockets. Bei Verwendung mit der Bindungsfunktion wird serviceClassId ignoriert. Wird auch ignoriert, wenn der Port angegeben ist. Gibt für die Verbindungsfunktion die eindeutige Bluetooth-Dienstklassen-ID des Diensts an, mit dem eine Verbindung hergestellt werden soll. Wenn das Peergerät über mehr als einen Port verfügt, der dem Dienstklassenbezeichner entspricht, versucht die Verbindungsfunktion , eine Verbindung mit dem ersten gültigen Dienst herzustellen. Dieser Mechanismus kann ohne vorherige SDP-Abfragen verwendet werden.

port

RFCOMM-Kanal, der dem Socket zugeordnet ist. Siehe Hinweise.

Hinweise

Bei Verwendung mit der Bindungsfunktion für Clientanwendungen muss der Portmember 0 sein, damit ein entsprechender lokaler Endpunkt zugewiesen werden kann. Bei Verwendung mit bindung in Serveranwendungen muss es sich bei dem Portmember um eine gültige Portnummer oder BT_PORT_ANY; Ports, die automatisch mithilfe von BT_PORT_ANY zugewiesen werden, können später mit einem Aufruf der getockname-Funktion abgefragt werden. Der gültige Bereich für die Anforderung eines bestimmten RFCOMM-Ports ist 1 bis 30.

Wenn Sie die Verbindungsfunktion verwenden, wenn serviceClassId nicht bereitgestellt wird, sollte der Port direkt die Remoteportnummer angeben, für die ein Verbindungsvorgang angefordert wird. Die Verwendung des Portmembers anstelle des ServiceClassId-Members erfordert, dass die Anwendung eine eigene Dienstsuche (SDP) durchführt, bevor sie den Verbindungsvorgang versucht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Kopfzeile	ws2bth.h

Weitere Informationen

Bluetooth und Binden

Bluetooth und getockname

Bluetooth und akzeptieren

Bluetooth und Verbinden