SIO_WSK_SET_SENDTO_ADDRESS
A operação de controle de E/S do soquete SIO_WSK_SET_SENDTO_ADDRESS permite que um aplicativo WSK especifique um endereço de transporte de destino fixo para um soquete de datagrama. Essa operação de controle de E/S de soquete se aplica somente a soquetes de datagrama.
Se um aplicativo WSK definir um endereço de transporte de destino fixo para um soquete de datagrama, todos os datagramas enviados pelo soquete serão enviados para o endereço de transporte de destino fixo. No entanto, os datagramas recebidos no soquete serão aceitos de qualquer endereço de transporte.
Um aplicativo WSK pode substituir um endereço de transporte de destino fixo quando envia um datagrama sobre o soquete especificando um endereço de transporte remoto alternativo no parâmetro RemoteAddress ao chamar a função WskSendTo . Nessa situação, o datagrama é enviado para o endereço de transporte remoto alternativo em vez do endereço de transporte de destino fixo.
Se um aplicativo WSK usar essa operação de controle de E/S de soquete para especificar um endereço de transporte de destino fixo, ele deverá fazer isso depois que o soquete de datagrama tiver sido associado a um endereço de transporte local.
Para definir um endereço de transporte de destino fixo para um soquete de datagrama, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.
| Parâmetro | Valor |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_WSK_SET_SENDTO_ADDRESS |
Level |
0 |
InputSize |
O tamanho da estrutura SOCKADDR apontada pelo parâmetro InputBuffer . |
Inputbuffer |
Um ponteiro para uma estrutura que especifica um endereço de transporte de destino fixo para o soquete de datagrama. O ponteiro deve ser um ponteiro para o tipo de estrutura SOCKADDR específico que corresponde à família de endereços especificada pelo aplicativo WSK ao criar o soquete de datagrama. |
OutputSize |
0 |
OutputBuffer |
NULO |
OutputSizeReturned |
NULO |
Para limpar um endereço de transporte de destino fixo para um soquete de datagrama, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.
| Parâmetro | Valor |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_WSK_SET_SENDTO_ADDRESS |
Level |
0 |
InputSize |
0 |
Inputbuffer |
NULO |
OutputSize |
0 |
OutputBuffer |
NULO |
OutputSizeReturned |
NULO |
Um aplicativo WSK deve especificar um ponteiro para um IRP ao chamar a função WskControlSocket para definir ou limpar um endereço de transporte de destino fixo para um soquete de datagrama.
Requisitos
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
parâmetro |
Wsk.h (inclua Wsk.h) |