КриптоПро SSPI  

QueryCredentialsAttributes

Функция 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Параметр phCredential содержит недействительный дескриптор удостоверения.
SEC_E_UNSUPPORTED_FUNCTIONПараметр ulAttribute содержит неподдерживаемый атрибут.

Примечания

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

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

Требования:

AIX: 5.3 или выше.
FreeBSD: 7 или выше.
Linux: LSB 3.1 (RHEL 4, SuSE 10) или выше.
Solaris: 10 или выше.
Windows 2000 или выше: Необходимо Windows 2000 SP4 или старше с Internet Explorer 6.0 или старше.
Файл описания: Прототип описан в файле sspi.h для Windows и CSP_Sspi.h, CSP_SChannel.h, CpSSP.h для Unix.

См. также

AcquireCredentialsHandle() ,FreeContextBuffer() ,SCHANNEL_CRED World Wide Web link ,SecPkgCred_CipherStrengths World Wide Web link