Partilhar 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á vinculado é exclusivamente reservado para uso por esse soquete. Essa opção de soquete aplica-se somente a soquetes de escuta, soquetes de datagrama e soquetes orientados para conexão.

Se um aplicativo WSK definir essa opção de soquete, ele deverá fazê-lo antes que o soquete seja vinculado 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 seguintes parâmetros.

Parâmetro Valor

RequestType

WskSetOption

ControlCode

SO_EXCLUSIVEADDRUSE

Nível

SOL_SOCKET

TamanhoDeEntrada

tamanho de (ULONG)

Buffer de Entrada

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

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

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

TamanhoDeSaída

0

Buffer de Saída

NULO

TamanhoDeSaídaRetornado

NULO

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

Parâmetro Valor

RequestType

WskGetOption

ControlCode

SO_EXCLUSIVEADDRUSE

Nível

SOL_SOCKET

TamanhoDeEntrada

0

Buffer de Entrada

NULO

TamanhoDeSaída

tamanho de (ULONG)

Buffer de Saída

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á desativado

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

TamanhoDeSaídaRetornado

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 local entre soquetes, consulte Compartilhando endereços de transporte.

Requerimentos

Versão

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

Cabeçalho

Ws2def.h (inclui Wsk.h)