Compartilhar via


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)