Функция QueryContextAttributesExW (sspi.h)
Позволяет транспортному приложению запрашивать пакет безопасности для определенных атрибутовконтекста безопасности.
Синтаксис
SECURITY_STATUS SEC_ENTRY QueryContextAttributesExW(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer,
[in] unsigned long cbBuffer
);
Параметры
[in] phContext
Дескриптор контекста безопасности для запроса.
[in] ulAttribute
Указывает атрибут возвращаемого контекста. Этот параметр может принимать одно из указанных ниже значений.
Значение | Значение |
---|---|
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_AccessToken .
Возвращает дескриптор маркера доступа. |
|
Параметр pBuffer содержит указатель на SecPkgContext_SessionAppData структуру.
Возвращает или задает данные приложения для сеанса. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Authority .
Запрашивает имя центра проверки подлинности. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_ClientSpecifiedTarget , представляющую имя субъекта-службы (SPN) исходного целевого объекта, предоставленного клиентом.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
|
Параметр pBuffer содержит указатель на SecPkgContext_ConnectionInfo структуру.
Возвращает подробные сведения об установленном подключении. Этот атрибут поддерживается только пакетом безопасности 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 .
Запросы ключевых данных, используемых протоколом EAP TLS. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Flags .
Возвращает сведения о согласованных флагах контекста. |
|
Параметр 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. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_LocalCredentialInfo . (Является устаревшим.) Заменено SECPKG_ATTR_LOCAL_CERT_CONTEXT. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Names .
Запрашивает имя, связанное с контекстом. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_NativeNames .
Возвращает имя участника (CNAME) из исходящего билета. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_NegotiationInfo .
Возвращает сведения о пакете безопасности, который будет использоваться в процессе согласования, и о текущем состоянии согласования для использования этого пакета. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_PackageInfo .
Возвращает сведения об используемом поставщике общих служб. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_PasswordExpiry .
Возвращает сведения об истечении срока действия пароля. |
|
Параметр pBuffer содержит указатель на структуру PCCERT_CONTEXT .
Находит контекст сертификата, содержащий конечный сертификат, предоставленный сервером. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр pBuffer содержит указатель на HCERTCONTEXT. Находит контекст сертификата, содержащий сертификат, предоставленный корневым хранилищем. |
|
Параметр pBuffer содержит указатель на SecPkgContext_SessionKey структуру.
Возвращает сведения о ключах сеанса. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_SessionInfo .
Возвращает сведения о сеансе. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Sizes .
Запрашивает размеры структур, используемых в функциях для каждого сообщения. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_StreamSizes .
Запрашивает размеры различных частей потока, используемых в функциях для каждого сообщения. Этот атрибут поддерживается только пакетом безопасности Schannel. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_SubjectAttributes .
Это значение возвращает сведения об атрибутах безопасности для подключения. Это значение поддерживается только на сервере 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 [только классические приложения] |
Целевая платформа | Windows |
Header | sspi.h (включая Security.h) |
Библиотека | Secur32.lib |
DLL | Secur32.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по