Função SaslGetContextOption (sspi.h)

A função SaslGetContextOption recupera a propriedade especificada do contexto SASL especificado.

Sintaxe

SECURITY_STATUS SEC_ENTRY SaslGetContextOption(
  [in]            PCtxtHandle ContextHandle,
  [in]            ULONG       Option,
  [out]           PVOID       Value,
  [out]           ULONG       Size,
  [out, optional] PULONG      Needed
);

Parâmetros

[in] ContextHandle

Identificador do contexto SASL.

[in] Option

Propriedade a ser retornada do contexto SASL. A tabela a seguir lista os valores possíveis.

Valor Significado
SASL_OPTION_AUTHZ_PROCESSING
Tipo de dados de buffer: ULONG

Estado do processamento SASL do valor Authz fornecido pelo aplicativo SASL. Os estados válidos para processamento são Sasl_AuthZIDForbidden e Sasl_AuthZIDProcessed.

SASL_OPTION_AUTHZ_STRING
Tipo de dados de buffer: matriz de caracteres binários

Cadeia de caracteres passada do cliente SASL para o servidor. Se o estado AuthZ_Processing for Sasl_AuthZIDForbidden, o valor retornado SEC_E_UNSUPPORTED_FUNCTION será retornado.

SASL_OPTION_RECV_SIZE
Tipo de dados de buffer: ULONG

Tamanho máximo do buffer de recebimento no computador local.

SASL_OPTION_SEND_SIZE
Tipo de dados de buffer: ULONG

Tamanho máximo de dados de mensagem que podem ser transmitidos. Esse valor é o tamanho máximo do buffer que pode ser transmitido para o processo SASL remoto menos o tamanho do bloco, o tamanho do trailer e o tamanho máximo da assinatura.

[out] Value

Um ponteiro para um buffer que recebe a propriedade solicitada. Para o tipo de dados do buffer para cada valor do parâmetro Option , consulte o parâmetro Option .

[out] Size

O tamanho, em bytes, do buffer especificado pelo parâmetro Value .

[out, optional] Needed

Um ponteiro para um valor LONG sem sinal que retorna o valor se o buffer especificado pelo parâmetro Value não for grande o suficiente para conter o valor de dados da propriedade especificada pelo parâmetro Option .

Valor retornado

Se a chamada for concluída com êxito, essa função retornará SEC_E_OK. A tabela a seguir mostra alguns valores de retorno de erro possíveis.

Código de retorno Descrição
SEC_E_BUFFER_TOO_SMALL
O buffer especificado pelo parâmetro Value não é grande o suficiente para conter o valor de dados da propriedade especificada pelo parâmetro Option .
SEC_E_INVALID_HANDLE
O identificador de contexto SASL especificado pelo parâmetro ContextHandle não foi encontrado na lista SASL.
SEC_E_UNSUPPORTED_FUNCTION
A opção especificada no parâmetro Option não é válida.

Requisitos

   
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho sspi.h (inclua Security.h)
Biblioteca Secur32.lib
DLL Secur32.dll