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.