Partilhar via


SIO_ADDRESS_LIST_QUERY

A operação de controle de E/S de 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. Esta operação de controle de E/S de soquete aplica-se 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çãoWskControlSocketcom os seguintes parâmetros.

Parâmetro Valor

RequestType

WskIoctl

ControlCode

SIO_ADDRESS_LIST_QUERY

Nível

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 de 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 do 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 local 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 de 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.

Requerimentos

Versão

Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.

Cabeçalho

Ws2def.h (inclui Wsk.h)