Функция SetCredentialsAttributesA (sspi.h)
Задает атрибутыучетных данных, например имя, связанное с учетными данными. Эти сведения допустимы для любого контекста безопасности , созданного с указанными учетными данными.
Синтаксис
SECURITY_STATUS SEC_ENTRY SetCredentialsAttributesA(
[in] PCredHandle phCredential,
[in] unsigned long ulAttribute,
[in] void *pBuffer,
unsigned long cbBuffer
);
Параметры
[in] phCredential
Дескриптор устанавливаемых учетных данных.
[in] ulAttribute
Задает задающийся атрибут . Этот параметр может быть любым из следующих атрибутов.
Значение | Значение |
---|---|
|
Задает имя учетных данных в параметре pBuffer типа SecPkgCredentials_Names.
Этот атрибут не поддерживается Schannel в режиме WOW64. |
|
Задает параметр прокси-сервера Kerberos в параметре pBuffer типа SecPkgCredentials_KdcProxySettings.
Этот атрибут поддерживается только Kerberos. |
|
Задает поддерживаемые алгоритмы в параметре pBuffer типа SecPkgCred_SupportedAlgs. Включаются все поддерживаемые алгоритмы независимо от того, поддерживаются ли они предоставленным сертификатом или включены на локальном компьютере.
Этот атрибут поддерживается только Schannel. |
|
Задает сильные стороны шифра в параметре pBuffer типа SecPkgCred_CipherStrengths.
Этот атрибут поддерживается только Schannel. |
|
Задает поддерживаемые алгоритмы в параметре pBuffer типа SecPkgCred_SupportedProtocols. Включаются все поддерживаемые протоколы независимо от того, поддерживаются ли они предоставленным сертификатом или включены на локальном компьютере.
Этот атрибут поддерживается только Schannel. |
[in] pBuffer
Указатель на буфер, содержащий новое значение атрибута. Тип возвращаемой структуры зависит от значения ulAttribute.
cbBuffer
Размер буфера pBuffer в байтах.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет SEC_E_OK.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов ошибок.
Код возврата | Описание |
---|---|
|
Дескриптор, переданный функции, недопустим. |
|
Указанный атрибут не поддерживается Schannel. Это возвращаемое значение будет возвращено только при использовании Schannel SSP. |
|
Недостаточно памяти для выполнения запроса. |
Комментарии
Примечание
Заголовок sspi.h определяет SetCredentialsAttributes в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | sspi.h (включая Security.h) |
Библиотека | Secur32.lib |
DLL | Secur32.dll |