Delen via


SIO_ADDRESS_LIST_QUERY

Met de SIO_ADDRESS_LIST_QUERY bewerking voor socket-I/O-beheer kan een WSK-toepassing een query uitvoeren op de huidige lijst met lokale transportadressen voor de adresfamilie van een socket. Deze socket I/O-besturingsbewerking is van toepassing op alle sockettypen.

Als u een query wilt uitvoeren op de huidige lijst met lokale transportadressen voor de adresfamilie van een socket, roept een WSK-toepassing de WskControlSocket--functie aan met de volgende parameters.

Parameter Waarde

RequestType-

WskIoctl-

ControlCode-

SIO_ADDRESS_LIST_QUERY

niveau

0

InputSize

0

InputBuffer

NUL

OutputSize

De grootte, in bytes, van de buffer waarnaar wordt verwezen door de parameter OutputBuffer.

OutputBuffer-

Een aanwijzer naar de buffer die de huidige lijst met lokale transportadressen ontvangt. De grootte van de buffer wordt opgegeven in de parameter OutputSize.

OutputSizeReturned

Een aanwijzer naar een ULONG-variabele die het aantal bytes aan gegevens ontvangt dat wordt gekopieerd naar de buffer waarnaar wordt verwezen door de parameter OutputBuffer.

Een WSK-toepassing geeft geen verwijzing naar een IRP op bij het aanroepen van de WskControlSocket functie om een query uit te voeren op de huidige lijst met lokale transportadressen voor de adresfamilie van een socket.

Als de aanroep van de WskControlSocket functie slaagt, bevat de uitvoerbuffer een SOCKET_ADDRESS_LIST structuur gevolgd door de SOCKADDR-structuren voor elk van de lokale transportadressen voor de adresfamilie van de socket.

Als de functie WskControlSocket STATUS_BUFFER_OVERFLOW retourneert, bevat de variabele waarnaar wordt verwezen door de parameter OutputSizeReturned de uitvoerbuffergrootte, in bytes, die nodig is om de volledige lijst met lokale transportadressen voor de adresfamilie van de socket te bevatten.

Met de SIO_ADDRESS_LIST_CHANGE bewerking voor socket-I/O-beheer kan een WSK-toepassing worden gewaarschuwd wanneer er een wijziging is aangebracht in de lijst met lokale transportadressen voor de adresfamilie van een socket.

Eisen

Versie

Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.

Rubriek

Ws2def.h (inclusief Wsk.h)