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

  • Статья

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

Синтаксис

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

Параметры

[in] ContextHandle

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

[in] Option

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

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

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

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

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

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

[in] Value

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

[in] Size

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

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

Если вызов выполнен успешно, эта функция возвращает 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