КриптоПро TLS

QueryContextAttributes

Функция QueryContextAttributes().

Возвращает информацию о свойствах данного контекста.

SECURITY_STATUS QueryContextAttributes (
  PCtxtHandle phContext, 
  ULONG ulAttribute, 
  PVOID pBuffer
);

Параметры:

phContext
[in] Дескриптор интересующего контекста.
ulAttribute
[in] Указывает, какой атрибут запрашивается. Допустимые аттибуты перечислены в следующей таблице:
Значение Возвращаемая информация Тип структуры pBuffer
SECPKG_ATTR_CONNECTION_INFO Протокол и используемые крипт. алгоритмы. SecPkgContext_ConnectionInfo
SECPKG_ATTR_ISSUER_LIST_EX Список доверенных центров сертификации. SecPkgContext_IssuerListInfoEx
SECPKG_ATTR_LIFESPAN Время истечения соединения. SecPkgContext_Lifespan
SECPKG_ATTR_NAMES Subject из сертификата удаленной стороны. SecPkgContext_Names
SECPKG_ATTR_REMOTE_CERT_CONTEXT Сертификат удаленной стороны. CERT_CONTEXT. См. заметки.
SECPKG_ATTR_STREAM_SIZES Размеры буферов для заголовка, блока данных и трейлера при шифровании. SecPkgContext_StreamSizes

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

Возвращает:

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

В противном случае функция возвращает ненулевой код ошибки.

Примечание:

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

Аттрибут SECPKG_ATTR_REMOTE_CERT_CONTEXT возвращает структуру CERT_CONTEXT. Ее необходимо освободить с помощью CertFreeCertificateContext.

Требования:

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.