SIO_WSK_SET_REMOTE_ADDRESS
A operação de controle de E/S do soquete SIO_WSK_SET_REMOTE_ADDRESS permite que um aplicativo WSK especifique um endereço de transporte remoto fixo para um soquete de datagrama. Essa operação de controle de E/S de soquete se aplica apenas a soquetes de datagrama.
Se um aplicativo WSK definir um endereço de transporte remoto fixo para um soquete de datagrama, todos os datagramas enviados pelo soquete serão enviados para o endereço de transporte remoto fixo e somente os datagramas recebidos do endereço de transporte remoto fixo serão aceitos.
Um aplicativo WSK pode substituir um endereço de transporte remoto fixo quando envia um datagram 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 remoto fixo. No entanto, todas as respostas enviadas de volta de um endereço de transporte remoto alternativo não serão aceitas.
Se um aplicativo WSK usar essa operação de controle de E/S de soquete para especificar um endereço de transporte remoto fixo, ele deverá fazê-lo depois que o soquete de datagrama tiver sido associado a um endereço de transporte local.
Para definir um endereço de transporte remoto fixo para um soquete de datagram, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.
| Parâmetro | Valor |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_WSK_SET_REMOTE_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 remoto 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 remoto fixo para um soquete de datagram, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.
| Parâmetro | Valor |
|---|---|
RequestType |
WskIoctl |
ControlCode |
SIO_WSK_SET_REMOTE_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 remoto 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) |