Функция QueryContextAttributesExA (sspi.h)
Позволяет приложению транспорта запрашивать пакета безопасности
Синтаксис
SECURITY_STATUS SEC_ENTRY QueryContextAttributesExA(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer,
[in] unsigned long cbBuffer
);
Параметры
[in] phContext
Дескриптор контекста безопасности для запроса.
[in] ulAttribute
Указывает атрибут возвращаемого контекста. Этот параметр может быть одним из следующих значений.
| Ценность | Значение |
|---|---|
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_AccessToken.
Возвращает дескриптор маркера доступа. |
|
Параметр Возвращает или задает данные приложения для сеанса. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр Запрашивает имя центра проверки подлинности. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_ClientSpecifiedTarget, представляющую имя субъекта-службы (SPN) исходного целевого объекта, предоставленного клиентом.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
|
Параметр Возвращает подробные сведения о установленном подключении. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_ClientCreds, указывающую учетные данные клиента.
Если учетные данные клиента являются именем пользователя и паролем, буфер представляет собой упакованную KERB_INTERACTIVE_LOGON структуру. Если учетные данные клиента — это имя пользователя и ПИН-код смарт-карты, буфер представляет собой упакованную KERB_CERTIFICATE_LOGON структуру. Если учетные данные клиента являются учетными данными сетевого удостоверения, буфер представляет собой маршалированную структуру SEC_WINNT_AUTH_IDENTITY_EX2. Этот атрибут поддерживается только на сервере CredSSP. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_DceInfo.
Запросы данных авторизации, используемых службами DCE. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Bindings, указывающую сведения о привязке канала.
Этот атрибут поддерживается только пакетом безопасности Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_EapKeyBlock.
Запросы к ключевым данным, используемым протоколом TLS EAP. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр Возвращает сведения о согласованных флагах контекста. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_IssuerListInfoEx.
Возвращает список издателей сертификатов, которые принимаются сервером. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_KeyInfo.
Запрашивает сведения о ключах, используемых в контексте безопасности. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_LastClientTokenStatus, которая указывает, является ли маркер из последнего вызова функции InitializeSecurityContext последним маркером от клиента.
Это значение поддерживается только пакетами безопасности Negotiate, Kerberos и NTLM. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Lifespan.
Запрашивает период жизни контекста. |
|
Параметр pBuffer содержит указатель на структуру PCCERT_CONTEXT.
Находит контекст сертификата, содержащий локальный конечный сертификат. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр Заменены SECPKG_ATTR_LOCAL_CERT_CONTEXT. |
|
Параметр Запрашивает имя, связанное с контекстом. |
|
Параметр Возвращает имя субъекта (CNAME) из исходящего билета. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_NegotiationInfo.
Возвращает сведения о пакете безопасности, который будет использоваться с процессом согласования и текущим состоянием переговоров по использованию этого пакета. |
|
Параметр Возвращает сведения об используемом поставщике служб SSP. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_PasswordExpiry.
Возвращает сведения об истечении срока действия пароля. |
|
Параметр pBuffer содержит указатель на структуру PCCERT_CONTEXT.
Находит контекст сертификата, содержащий конечный сертификат, предоставленный сервером. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_SessionKey.
Возвращает сведения о ключах сеанса. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_SessionInfo.
Возвращает сведения о сеансе. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Sizes.
Запрашивает размеры структур, используемых в функциях каждого сообщения. |
|
Параметр Запрашивает размеры различных частей потока, используемых в функциях каждого сообщения. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр Это значение возвращает сведения об атрибутах безопасности для подключения. Это значение поддерживается только на сервере CredSSP. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_SupportedSignatures.
Это значение возвращает сведения о типах подписей, поддерживаемых для подключения. Это значение поддерживается только пакетом безопасности Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_TargetInformation.
Возвращает сведения о имени удаленного сервера. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Bindings, указывающую сведения о привязке канала.
Это значение поддерживается только пакетом безопасности Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
[out] pBuffer
Указатель на структуру, которая получает атрибуты. Тип структуры, на который указывает, зависит от значения, указанного в параметре ulAttribute.
[in] cbBuffer
Размер в байтах параметра pBuffer.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение SEC_E_OK.
Если функция завершается ошибкой, возвращаемое значение является ненулевом кодом ошибки.
Замечания
Заметка
Заголовок sspi.h определяет QueryContextAttributesEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | sspi.h (include Security.h) |
| библиотеки |
Secur32.lib |
| DLL | Secur32.dll |
См. также
функций SSPI