Partilhar via


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. Esta operação de controlo de E/S de socket aplica-se apenas a sockets 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 datagrama sobre o soquete especificando um endereço de transporte remoto alternativo no parâmetro RemoteAddress ao chamar a funçãoWskSendTo. 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, não serão aceites quaisquer respostas enviadas a partir de um endereço de transporte remoto alternativo.

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 vinculado a um endereço de transporte local.

Para definir um endereço de transporte remoto fixo para um soquete de datagrama, um aplicativo WSK chama o função WskControlSocket com os seguintes parâmetros.

Parâmetro Valor

RequestType

WskIoctl

ControlCode

SIO_WSK_SET_REMOTE_ADDRESS

Nível

0

InputSize

O tamanho da estrutura SOCKADDR apontado 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 que o aplicativo WSK especificou quando criou o soquete de datagrama.

OutputSize

0

OutputBuffer

NULO

OutputSizeReturned

NULO

Para limpar um endereço de transporte remoto fixo para um soquete de datagrama, um aplicativo WSK chama a função WskControlSocket com os seguintes parâmetros.

Parâmetro Valor

RequestType

WskIoctl

ControlCode

SIO_WSK_SET_REMOTE_ADDRESS

Nível

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.

Requerimentos

Versão

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

Cabeçalho

Wsk.h (inclui Wsk.h)