КриптоПро TLS

QueryCredentialsAttributes

Возвращает информацию о свойствах данного удостоверения. Эта информация является общей для всех соединений, созданных с этим удостоверением.

SECURITY_STATUS QueryCredentialsAttributes (
  PCredHandle phCredential, 
  unsigned long ulAttribute, 
  void SEC_FAR * pBuffer
);

Параметры:

phCredential

[in] Дескриптор интересующего удостоверения.

ulAttribute

[in] Указывает, какой атрибут запрашивается. Допустимые аттибуты перечислены в следующей таблице:

Значение	Возвращаемая информация	Тип структуры pBuffer
SECPKG_ATTR_SUPPORTED_ALGS	Поддерживаемые криптографические алгоритмы	SecPkgCred_SupportedAlgs
SECPKG_ATTR_CIPHER_STRENGTHS	Длина ключа в битах	SecPkgCred_CipherStrengths
SECPKG_ATTR_SUPPORTED_PROTOCOLS	Поддерживаемые протоколы	SecPkgCred_SupportedProtocols

pBuffer

[in/out] Указатель на структуру, куда будет помещен атрибут. Тип структуры зависит от параметра ulAttribute.

Возвращает:

При успешном завершении функция возвращает SEC_E_OK.

В случае ошибки функция возвращает одно из следующих значений:

Возвращаемые значения	Описание
SEC_E_INVALID_HANDLE	Параметр phContext содержит недействительный дескриптор контекста.
SEC_E_UNSUPPORTED_FUNCTION	Параметр ulAttribute содержит неподдерживаемый атрибут.

Примечание:

Изначально атрибуты соединения задаются в структуре SCHANNEL_CRED при вызове AcquireCredentialsHandle().

Память для структуры, указанной в pBuffer, отводит приложение, а память для динамических элементов этой структуры отводит SSP, и ее необходимо освободить с помощью FreeContextBuffer().

Требования:

Windows NT/2000/XP: Необходимо Windows NT 4.0 SP5 или старше с Internet Explorer 5.0 или старше.
Windows 98/ME: Необходимо Windows 95 OSR2 или старше с Internet Explorer 5.0 или старше.
Файл описания: Прототип описан в файле Sspi.h.

См. также:

AcquireCredentialsHandle() , FreeContextBuffer() , SCHANNEL_CRED() , SecPkgCred_CipherStrengths()