Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 do 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 |
do ControlCode |
SIO_ADDRESS_LIST_QUERY |
de nível de |
0 |
InputSize |
0 |
InputBuffer |
ZERO |
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 locais. 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 que é 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 de SOCKET_ADDRESS_LIST seguida pelas estruturas SOCKADDR para cada um dos endereços de transporte locais da família de endereços do soquete.
Se a função WskControlSocket retornar STATUS_BUFFER_OVERFLOW, a variável que é apontada pelo parâmetro OutputSizeReturned contém o tamanho do buffer de saída, em bytes, que é 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 locais 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) |