Compartilhar 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 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)