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) |