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