Поделиться через


Функция 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

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

Значение Значение
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

См. также раздел

AcquireCredentialsHandle

FreeContextBuffer

SCH_CREDENTIALS

Функции SSPI

SecPkgCred_CipherStrengths

SecPkgCred_SupportedAlgs

SecPkgCred_SupportedProtocols

SecPkgCredentials_Names