Função SaslSetContextOption (sspi.h)

  • Artigo

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