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

Статья
11/20/2024

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

Синтаксис

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY SetCredentialsAttributesW(
  [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 [только классические приложения]
целевая платформа	Виндоус
заголовка	sspi.h (include Security.h)
библиотеки	Secur32.lib
DLL	Secur32.dll