Función SaslSetContextOption (sspi.h)

  • Artículo

La función SaslSetContextOption establece el valor de la propiedad especificada para el contexto saSL especificado.

Sintaxis

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

Parámetros

[in] ContextHandle

Identificador del contexto de SASL.

[in] Option

Propiedad que se va a establecer para el contexto de SASL. En la tabla siguiente se enumeran los valores posibles.

Valor Significado
SASL_OPTION_AUTHZ_PROCESSING
 Tipo de datos de búfer: ULONG

Estado del procesamiento de SASL del valor authz proporcionado por la aplicación SASL. Los estados válidos para el procesamiento son Sasl_AuthZIDForbidden y Sasl_AuthZIDProcessed. El valor predeterminado es Sasl_AuthZIDProcessed.
SASL_OPTION_AUTHZ_STRING
 Tipo de datos de búfer: matriz de caracteres binarios

Cadena de caracteres pasados del cliente SASL al servidor. Si el estado AuthZ_Processing es Sasl_AuthZIDForbidden, se devuelve el valor devuelto SEC_E_UNSUPPORTED_FUNCTION.
SASL_OPTION_RECV_SIZE
 Tipo de datos de búfer: ULONG

Tamaño máximo del búfer receptor en el equipo local. El valor predeterminado es 0x0FFFF bytes.
SASL_OPTION_SEND_SIZE
 Tipo de datos de búfer: ULONG

Tamaño máximo de datos de mensaje que se puede transmitir. Este valor es el tamaño máximo del búfer que se puede transmitir al proceso saSL remoto menos el tamaño del bloque, el tamaño del finalizador y el tamaño máximo de firma. El valor predeterminado es 0x0FFFF bytes.

[in] Value

Puntero a un búfer que contiene el valor que se va a establecer en la propiedad solicitada. Para el tipo de datos del búfer para cada valor del parámetro Option , consulte el parámetro Option .

[in] Size

Tamaño, en bytes, del búfer especificado por el parámetro Value .

Valor devuelto

Si la llamada se completa correctamente, esta función devuelve SEC_E_OK. En la tabla siguiente se muestran algunos valores devueltos de error posibles.

Código devuelto Descripción
SEC_E_BUFFER_TOO_SMALL
 El búfer especificado por el parámetro Value no es lo suficientemente grande como para contener el valor de datos de la propiedad especificada por el parámetro Option .
SEC_E_INVALID_HANDLE
 El identificador de contexto de SASL especificado por el parámetro ContextHandle no se encontró en la lista de SASL.
SEC_E_UNSUPPORTED_FUNCTION
 La opción especificada en el parámetro Option no es válida.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado sspi.h (include Security.h)
Library Secur32.lib
Archivo DLL Secur32.dll