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 datagram. Essa operação de controle de E/S do soquete se aplica somente a soquetes de datagrama.

Se um aplicativo WSK definir um endereço de transporte remoto fixo para um soquete de datagram, todos os datagramas enviados pelo soquete serão enviados para o endereço de transporte remoto fixo e apenas 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 pelo soquete especificando um endereço de transporte remoto alternativo no parâmetro RemoteAddress ao chamar a função WskSendTo. Nessa situação, o datagram é 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
do ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
de nível de	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	ZERO
OutputSizeReturned	ZERO

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
do ControlCode	SIO_WSK_SET_REMOTE_ADDRESS
de nível de	0
InputSize	0
InputBuffer	ZERO
OutputSize	0
OutputBuffer	ZERO
OutputSizeReturned	ZERO

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 datagram.

Requisitos

Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	Wsk.h (inclua Wsk.h)