Função SaslSetContextOption (sspi.h)

Artigo
08/26/2023

A função SaslSetContextOption define o valor da propriedade especificada para o contexto SASL especificado.

Sintaxe

SECURITY_STATUS SEC_ENTRY SaslSetContextOption(
  [in] PCtxtHandle ContextHandle,
  [in] ULONG       Option,
  [in] PVOID       Value,
  [in] ULONG       Size
);

Parâmetros

[in] ContextHandle

Identificador do contexto SASL.

[in] Option

Propriedade a ser definida para o 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. O valor padrão é 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. O valor padrão é 0x0FFFF bytes.
SASL_OPTION_SEND_SIZE	Tipo de dados de buffer: ULONG Tamanho máximo dos dados da 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. O valor padrão é 0x0FFFF bytes.

[in] Value

Um ponteiro para um buffer que contém o valor a ser definido como a propriedade solicitada. Para o tipo de dados do buffer para cada valor do parâmetro Option , consulte o parâmetro Option .

[in] Size

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

Retornar valor

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

Requisito	Valor
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

Share via