Функция обратного вызова SpQueryContextAttributesFn (ntsecpkg.h)

  • Статья

Функция SpQueryContextAttributes извлекает атрибуты контекста безопасности.

Функция SpQueryContextAttributes — это функция диспетчеризации для функции QueryContextAttributes (General)интерфейса поставщика поддержки безопасности.

Синтаксис

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

Параметры

[in] ContextHandle

Дескриптор контекста безопасности.

[in] ContextAttribute

Атрибут контекста для запроса. Список допустимых значений см. в функции QueryContextAttributes (Общие).

[out] Buffer

Указатель, получающий адрес буфера, содержащего запрошенные атрибуты. Память для параметра Buffer должна быть выделена с помощью функции AllocateHeap из таблицы функций SECPKG_DLL_FUNCTIONS в пользовательском режиме. В режиме локального центра безопасности (LSA) используйте функцию AllocateLsaHeap .

Возвращаемое значение

Если функция выполнена успешно, верните STATUS_SUCCESS.

Если функция завершается сбоем, верните код NTSTATUS , указывающий причину сбоя. Ниже перечислены распространенные причины сбоя и код ошибки, который должна вернуть функция.

Код возврата Описание
SEC_E_INVALID_HANDLE
 Недопустимый дескриптор.

Комментарии

SSP/APs должны реализовывать функцию SpQueryContextAttributes ; однако фактическое имя, присваиваемого реализации, задается разработчиком.

Указатель на реализацию функции SpQueryContextAttributes в режиме LSA доступен в структуре SECPKG_FUNCTION_TABLE, полученной от функции SpLsaModeInitialize .

Указатель на реализацию пользовательского режима функции SpQueryContextAttributes доступен в структуре SECPKG_USER_FUNCTION_TABLE, полученной от функции SpUserModeInitialize .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntsecpkg.h

См. также раздел

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize