SIO_ADDRESS_LIST_QUERY

Der SIO_ADDRESS_LIST_QUERY Socket-E/A-Steuerungsvorgang ermöglicht es einer WSK-Anwendung, die aktuelle Liste der lokalen Transportadressen für die Adressfamilie eines Sockets abzufragen. Dieser Socket-E/A-Steuerungsvorgang gilt für alle Sockettypen.

Um die aktuelle Liste der lokalen Transportadressen für die Adressfamilie eines Sockets abzufragen, ruft eine WSK-Anwendung die WskControlSocket-Funktion mit den folgenden Parametern auf.

Parameter	Wert
Requesttype	WskIoctl
ControlCode	SIO_ADDRESS_LIST_QUERY
Level	0
InputSize	0
Inputbuffer	NULL
OutputSize	Die Größe des Puffers in Bytes, auf den der OutputBuffer-Parameter verweist.
OutputBuffer	Ein Zeiger auf den Puffer, der die aktuelle Liste der lokalen Transportadressen empfängt. Die Größe des Puffers wird im OutputSize-Parameter angegeben.
OutputSizeReturned	Ein Zeiger auf eine Variable vom Typ ULONG, die die Anzahl der Byte von Daten empfängt, die in den Puffer kopiert werden, auf den der OutputBuffer-Parameter verweist.

Eine WSK-Anwendung gibt keinen Zeiger auf eine IRP an, wenn die WskControlSocket-Funktion aufgerufen wird , um die aktuelle Liste der lokalen Transportadressen für die Adressfamilie eines Sockets abzufragen.

Wenn der Aufruf der WskControlSocket-Funktion erfolgreich ist, enthält der Ausgabepuffer eine SOCKET_ADDRESS_LIST-Struktur gefolgt von den SOCKADDR-Strukturen für jede der lokalen Transportadressen für die Adressfamilie des Sockets.

Wenn die WskControlSocket-Funktion STATUS_BUFFER_OVERFLOW zurückgibt, enthält die Variable, auf die der Parameter OutputSizeReturned verweist, die Ausgabepuffergröße in Bytes, die die vollständige Liste der lokalen Transportadressen für die Adressfamilie des Sockets enthalten muss.

Der SIO_ADDRESS_LIST_CHANGE Socket-E/A-Steuerungsvorgang ermöglicht es einer WSK-Anwendung, benachrichtigt zu werden, wenn eine Änderung der Liste der lokalen Transportadressen für die Adressfamilie eines Sockets erfolgt ist.

Requirements (Anforderungen)

Version	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Header	Ws2def.h (einschließen von Wsk.h)