Compartilhar via


SO_EXCLUSIVEADDRUSE

O estado da opção de soquete SO_EXCLUSIVEADDRUSE determina se o endereço de transporte local ao qual um soquete será associado é reservado exclusivamente para uso por esse soquete. Essa opção de soquete se aplica somente a soquetes de escuta, soquetes de datagrama e soquetes orientados à conexão.

Se um aplicativo WSK definir essa opção de soquete, ele deverá fazer isso antes que o soquete seja associado a um endereço de transporte local.

Para definir o estado dessa opção de soquete, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.

Parâmetro Valor

RequestType

WskSetOption

ControlCode

SO_EXCLUSIVEADDRUSE

Level

SOL_SOCKET

InputSize

sizeof(ULONG)

Inputbuffer

Um ponteiro para uma variável do tipo ULONG que contém o valor do novo estado da opção de soquete:

0: Desabilitar o uso exclusivo do endereço de transporte local

1: Habilitar o uso exclusivo do endereço de transporte local

OutputSize

0

OutputBuffer

NULO

OutputSizeReturned

NULO

Para recuperar o estado dessa opção de soquete, um aplicativo WSK chama a função WskControlSocket com os parâmetros a seguir.

Parâmetro Valor

RequestType

WskGetOption

ControlCode

SO_EXCLUSIVEADDRUSE

Level

SOL_SOCKET

InputSize

0

Inputbuffer

NULO

OutputSize

sizeof(ULONG)

OutputBuffer

Um ponteiro para uma variável do tipo ULONG que recebe o valor do estado da opção de soquete:

0: O uso exclusivo do endereço de transporte local está desabilitado

1: O uso exclusivo do endereço de transporte local está habilitado

OutputSizeReturned

NULO

Um aplicativo WSK deve especificar um ponteiro para um IRP ao chamar a função WskControlSocket para definir ou recuperar o estado da opção de soquete SO_EXCLUSIVEADDRUSE.

O estado padrão dessa opção de soquete é que o uso exclusivo do endereço de transporte local está desabilitado.

Para obter mais informações sobre como usar a opção de soquete SO_EXCLUSIVEADDRUSE e seu impacto no compartilhamento de endereços de transporte locais entre soquetes, consulte Compartilhando endereços de transporte.

Requisitos

Versão

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

parâmetro

Ws2def.h (inclua Wsk.h)