SOCKET_ADDRESS_LIST-Struktur (ws2def.h)

Die SOCKET_ADDRESS_LIST-Struktur definiert eine Liste von Transportadressen mit variabler Größe.

Syntax

typedef struct _SOCKET_ADDRESS_LIST {
  INT            iAddressCount;
  SOCKET_ADDRESS Address[1];
} SOCKET_ADDRESS_LIST, *PSOCKET_ADDRESS_LIST, *LPSOCKET_ADDRESS_LIST;

Member

iAddressCount

Die Anzahl der Transportadressen in der Liste.

Address[1]

Ein Array mit variabler Größe von SOCKET_ADDRESS Strukturen. Die SOCKET_ADDRESS-Struktur ist wie folgt definiert:

typedef struct _SOCKET_ADDRESS {
  LPSOCKADDR  lpSockaddr;
  INT  iSockaddrLength;
} SOCKET_ADDRESS, *PSOCKET_ADDRESS, *LPSOCKET_ADDRESS;

lpSockaddr

Ein Zeiger auf einen Puffer, der eine Transportadresse enthält.

iSockaddrLength

Die Größe des SOCKADDR-Strukturtyps in Bytes, auf den das lpSockaddr-Element verweist.

Hinweise

Eine WSK-Anwendung übergibt einen Puffer an die WskControlSocket-Funktion , wenn die WSK-Anwendung die aktuelle Liste der lokalen Transportadressen abfragt, die der Adressfamilie eines Sockets entsprechen. Wenn der Aufruf der WskControlSocket-Funktion erfolgreich ist, enthält der Puffer eine SOCKET_ADDRESS_LIST-Struktur gefolgt von den SOCKADDR-Strukturen für jede der lokalen Transportadressen, die der Adressfamilie des Sockets entsprechen. Das WSK-Subsystem füllt das Adressarray aus und legt den iAddressCount-Member auf die Anzahl der Einträge im Array fest. Die lpSockaddr-Zeiger in jeder der SOCKET_ADDRESS Strukturen im Array verweisen auf den spezifischen SOCKADDR-Strukturtyp, der der Adressfamilie entspricht, die die WSK-Anwendung beim Erstellen des Sockets angegeben hat.

Weitere Informationen zum Abfragen der aktuellen Liste der lokalen Transportadressen finden Sie unter SIO_ADDRESS_LIST_QUERY.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile ws2def.h (einschließen von Wsk.h)

Weitere Informationen

SIO_ADDRESS_LIST_QUERY

SOCKADDR

WskControlSocket