SIO_ADDRESS_LIST_QUERY

A operação de controle de E/S do soquete SIO_ADDRESS_LIST_QUERY permite que um aplicativo WSK consulte a lista atual de endereços de transporte local para a família de endereços de um soquete. Essa operação de controle de E/S de soquete se aplica a todos os tipos de soquete.

Para consultar a lista atual de endereços de transporte local para a família de endereços de um soquete, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.

Parâmetro	Valor
RequestType	WskIoctl
ControlCode	SIO_ADDRESS_LIST_QUERY
Level	0
InputSize	0
Inputbuffer	NULO
OutputSize	O tamanho, em bytes, do buffer apontado pelo parâmetro OutputBuffer .
OutputBuffer	Um ponteiro para o buffer que recebe a lista atual de endereços de transporte local. O tamanho do buffer é especificado no parâmetro OutputSize .
OutputSizeReturned	Um ponteiro para uma variável do tipo ULONG que recebe o número de bytes de dados copiados para o buffer apontado pelo parâmetro OutputBuffer .

Um aplicativo WSK não especifica um ponteiro para um IRP ao chamar a função WskControlSocket para consultar a lista atual de endereços de transporte local para a família de endereços de um soquete.

Se a chamada para a função WskControlSocket for bem-sucedida, o buffer de saída conterá uma estrutura SOCKET_ADDRESS_LIST seguida pelas estruturas SOCKADDR para cada um dos endereços de transporte locais para a família de endereços do soquete.

Se a função WskControlSocket retornar STATUS_BUFFER_OVERFLOW, a variável apontada pelo parâmetro OutputSizeReturned conterá o tamanho do buffer de saída, em bytes, necessário para conter a lista completa de endereços de transporte local para a família de endereços do soquete.

A operação de controle de E/S do soquete SIO_ADDRESS_LIST_CHANGE permite que um aplicativo WSK seja notificado quando houver uma alteração na lista de endereços de transporte local para a família de endereços de um soquete.

Requisitos

Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	Ws2def.h (inclua Wsk.h)