Функция QueryContextAttributesW (sspi.h)
Функция QueryContextAttributes (CredSSP) позволяет транспортному приложению запрашивать пакет безопасности credSSP для определенных атрибутовконтекста безопасности.
Синтаксис
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY QueryContextAttributesW(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer
);
Параметры
[in] phContext
Дескриптор контекста безопасности для запроса.
[in] ulAttribute
Атрибут возвращаемого контекста. Этот параметр может принимать одно из указанных ниже значений. Если не указано иное, атрибуты применимы как к клиенту, так и к серверу.
| Значение | Значение |
|---|---|
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_AccessToken , которая указывает маркер доступа для текущего контекста безопасности.
Этот атрибут поддерживается только на сервере. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_AccessToken , которая указывает маркер доступа для текущего контекста безопасности.
Этот атрибут поддерживается только на сервере. |
|
Параметр pBuffer содержит указатель на структуру CERT_TRUST_STATUS , которая указывает сведения о доверии к сертификату.
Этот атрибут поддерживается только на клиенте. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_ClientCreds , указывающую учетные данные клиента.
Учетные данные клиента могут быть либо именем пользователя и паролем, либо именем пользователя и смарт-карта ПИН-кодом. Этот атрибут поддерживается только на сервере. |
|
Параметр 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_PackageInfo , которая указывает имя пакета проверки подлинности, согласованного поставщиком Microsoft Negotiate . |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_PackageInfo .
Возвращает сведения об используемом поставщике общих служб. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Flags , которая указывает сведения о флагах в текущем контексте безопасности.
Этот атрибут поддерживается только на клиенте. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_Sizes .
Запрашивает размеры структур, используемых в функциях для каждого сообщения и обменах проверкой подлинности. |
|
Параметр pBuffer содержит указатель на структуру SecPkgContext_SubjectAttributes .
Это значение возвращает сведения об атрибутах безопасности для подключения. Это значение поддерживается только на сервере CredSSP. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
[out] pBuffer
Указатель на структуру, которая получает атрибуты. Тип структуры зависит от значения параметра ulAttribute .
Возвращаемое значение
Если функция завершается успешно, она возвращает SEC_E_OK.
Если функция завершается сбоем, она может вернуть следующие коды ошибок.
| Возвращаемый код/значение | Описание |
|---|---|
|
Сбой функции. Параметр phContext указывает дескриптор неполного контекста. |
|
Сбой функции. Недопустимое значение параметра ulAttribute . |
Комментарии
Структура, на которую указывает параметр pBuffer , зависит от запрашиваемого атрибута.
Хотя вызывающий объект должен выделить саму структуру pBuffer , поставщик общих служб выделяет любую память, необходимую для хранения элементов структуры pBuffer переменной величины. Память, выделенная поставщиком общих служб, должна быть освобождена путем вызова функции FreeContextBuffer .
Примечание
Заголовок sspi.h определяет QueryContextAttributes в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | sspi.h (включая Security.h) |
| Библиотека | Secur32.lib |
| DLL | Secur32.dll |