Функция SaslGetContextOption (sspi.h)

  • Статья

Функция SaslGetContextOption извлекает указанное свойство заданного контекста SASL.

Синтаксис

SECURITY_STATUS SEC_ENTRY SaslGetContextOption(
  [in]            PCtxtHandle ContextHandle,
  [in]            ULONG       Option,
  [out]           PVOID       Value,
  [out]           ULONG       Size,
  [out, optional] PULONG      Needed
);

Параметры

[in] ContextHandle

Дескриптор контекста SASL.

[in] Option

Свойство, возвращаемое из контекста SASL. В следующей таблице перечислены возможные значения.

Значение Значение
SASL_OPTION_AUTHZ_PROCESSING
 Тип данных буфера: ULONG

Состояние обработки SASL значения Authz, предоставляемого приложением SASL. Допустимыми состояниями для обработки являются Sasl_AuthZIDForbidden и Sasl_AuthZIDProcessed.
SASL_OPTION_AUTHZ_STRING
 Тип данных буфера: массив двоичных символов

Строка символов, передаваемых от клиента SASL на сервер. Если состояние AuthZ_Processing Sasl_AuthZIDForbidden, возвращается SEC_E_UNSUPPORTED_FUNCTION возвращаемое значение.
SASL_OPTION_RECV_SIZE
 Тип данных буфера: ULONG

Максимальный размер принимающего буфера на локальном компьютере.
SASL_OPTION_SEND_SIZE
 Тип данных буфера: ULONG

Максимальный размер данных сообщения, которые могут быть переданы. Это значение представляет собой максимальный размер буфера, который может быть передан в удаленный процесс SASL за вычетом размера блока, размера трейлера и максимального размера подписи.

[out] Value

Указатель на буфер, получающий запрошенное свойство. Тип данных буфера для каждого значения параметра Option см. в параметре Option .

[out] Size

Размер (в байтах) буфера, заданного параметром Value .

[out, optional] Needed

Указатель на неподписаемое значение LONG , которое возвращает значение, если буфер, заданный параметром Value , недостаточно велик для хранения значения данных свойства, заданного параметром Option .

Возвращаемое значение

Если вызов выполнен успешно, эта функция возвращает SEC_E_OK. В следующей таблице показаны некоторые возможные возвращаемые значения ошибок.

Код возврата Описание
SEC_E_BUFFER_TOO_SMALL
 Буфер, заданный параметром Value, недостаточно велик, чтобы содержать значение данных свойства, заданного параметром Option .
SEC_E_INVALID_HANDLE
 Дескриптор контекста SASL, указанный параметром ContextHandle , не найден в списке SASL.
SEC_E_UNSUPPORTED_FUNCTION
 Параметр, указанный в параметре Option , недопустим.

Требования

   
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header sspi.h (включая Security.h)
Библиотека Secur32.lib
DLL Secur32.dll