Udostępnij za pośrednictwem


SIO_ADDRESS_LIST_QUERY

Operacja sterowania we/wy gniazda SIO_ADDRESS_LIST_QUERY umożliwia aplikacji WSK wykonywanie zapytań dotyczących bieżącej listy lokalnych adresów transportu dla rodziny adresów gniazda. Ta operacja sterowania we/wy gniazda ma zastosowanie do wszystkich typów gniazd.

Aby zbadać bieżącą listę lokalnych adresów transportu dla rodziny adresów gniazda, aplikacja WSK wywołuje funkcję WskControlSocket z następującymi parametrami.

Parametr Wartość

RequestType

WskIoctl

ControlCode

SIO_ADDRESS_LIST_QUERY

poziom

0

InputSize

0

InputBuffer

ZERO

OutputSize

Rozmiar w bajtach buforu wskazywanego przez parametr OutputBuffer.

OutputBuffer

Wskaźnik do buforu, który odbiera bieżącą listę lokalnych adresów transportu. Rozmiar buforu jest określony w parametrze OutputSize.

OutputSizeReturned

Wskaźnik do zmiennej typu ULONG, która odbiera liczbę bajtów danych skopiowanych do buforu wskazywanego przez parametr OutputBuffer.

Aplikacja WSK nie określa wskaźnika do protokołu IRP podczas wywoływania funkcji WskControlSocket, aby wykonać zapytanie dotyczące bieżącej listy lokalnych adresów transportu dla rodziny adresów gniazda.

Jeśli wywołanie funkcji WskControlSocket powiedzie się, bufor wyjściowy zawiera strukturę SOCKET_ADDRESS_LIST, po której następuje struktura SOCKADDR dla każdego z lokalnych adresów transportowych rodziny adresów gniazda.

Jeśli funkcja WskControlSocket zwraca STATUS_BUFFER_OVERFLOW, zmienna wskazywana przez parametr OutputSizeReturned zawiera rozmiar buforu wyjściowego w bajtach, który jest wymagany do zawierania pełnej listy lokalnych adresów transportowych dla rodziny adresów gniazda.

Operacja sterowania we/wy gniazda SIO_ADDRESS_LIST_CHANGE umożliwia aplikacji WSK powiadamianie o zmianie listy lokalnych adresów transportowych dla rodziny adresów gniazda.

Wymagania

Wersja

Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows.

Nagłówek

Ws2def.h (w tym Wsk.h)