Compartir a través de

Función SaslGetContextOption (sspi.h)

  • Artículo

La función SaslGetContextOption recupera la propiedad especificada del contexto SASL especificado.

Sintaxis

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 del contexto de SASL.

[in] Option

Propiedad que se va a devolver desde 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.
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 de 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 de recepción en el equipo local.
SASL_OPTION_SEND_SIZE
 Tipo de datos de búfer: ULONG

Tamaño máximo de datos del 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 la firma.

[out] Value

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

[out] Size

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

[out, optional] Needed

Puntero a un valor LONG sin signo que devuelve el valor si 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 .

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

   
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