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.
[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 |
---|---|
|
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 . |
|
O identificador de contexto SASL especificado pelo parâmetro ContextHandle não foi encontrado na lista SASL. |
|
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 |