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

Статья
03/08/2023

Задает атрибуты учетных данных, например имя, связанное с учетными данными. Эти сведения допустимы для любого контекста безопасности , созданного с указанными учетными данными.

Синтаксис

SECURITY_STATUS SEC_ENTRY SetCredentialsAttributesA(
  [in] PCredHandle   phCredential,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
       unsigned long cbBuffer
);

Параметры

[in] phCredential

Дескриптор устанавливаемых учетных данных.

[in] ulAttribute

Задает задающийся атрибут . Этот параметр может быть любым из следующих атрибутов.

Значение	Значение
SECPKG_CRED_ATTR_NAMES	Задает имя учетных данных в параметре pBuffer типа SecPkgCredentials_Names. Этот атрибут не поддерживается Schannel в режиме WOW64.
SECPKG_CRED_ATTR_KDC_PROXY_SETTINGS	Задает параметр прокси-сервера Kerberos в параметре pBuffer типа SecPkgCredentials_KdcProxySettings. Этот атрибут поддерживается только Kerberos.
SECPKG_ATTR_SUPPORTED_ALGS	Задает поддерживаемые алгоритмы в параметре pBuffer типа SecPkgCred_SupportedAlgs. Включаются все поддерживаемые алгоритмы независимо от того, поддерживаются ли они предоставленным сертификатом или включены на локальном компьютере. Этот атрибут поддерживается только Schannel.
SECPKG_ATTR_CIPHER_STRENGTHS	Задает сильные стороны шифра в параметре pBuffer типа SecPkgCred_CipherStrengths. Этот атрибут поддерживается только Schannel.
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Задает поддерживаемые алгоритмы в параметре pBuffer типа SecPkgCred_SupportedProtocols. Включаются все поддерживаемые протоколы независимо от того, поддерживаются ли они предоставленным сертификатом или включены на локальном компьютере. Этот атрибут поддерживается только Schannel.

[in] pBuffer

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

cbBuffer

Размер буфера pBuffer в байтах.

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

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

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

Код возврата	Описание
SEC_E_INVALID_HANDLE	Дескриптор, переданный функции, недопустим.
SEC_E_UNSUPPORTED_FUNCTION	Указанный атрибут не поддерживается Schannel. Это возвращаемое значение будет возвращено только при использовании Schannel SSP.
SEC_E_INSUFFICIENT_MEMORY	Недостаточно памяти для выполнения запроса.

Заголовок sspi.h определяет SetCredentialsAttributes в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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