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 |