Функция AuthzInitializeContextFromToken (authz.h)

Статья
02/23/2024

Функция AuthzInitializeContextFromToken инициализирует контекст авторизации клиента из маркера ядра. Маркер ядра должен быть открыт для TOKEN_QUERY.

Начиная с Windows Server 2012 и Windows 8 эта функция также может копировать группы устройств, утверждения пользователей и утверждения устройств.

Синтаксис

AUTHZAPI BOOL AuthzInitializeContextFromToken(
  [in]           DWORD                         Flags,
  [in]           HANDLE                        TokenHandle,
  [in]           AUTHZ_RESOURCE_MANAGER_HANDLE hAuthzResourceManager,
  [in, optional] PLARGE_INTEGER                pExpirationTime,
  [in]           LUID                          Identifier,
  [in, optional] PVOID                         DynamicGroupArgs,
  [out]          PAUTHZ_CLIENT_CONTEXT_HANDLE  phAuthzClientContext
);

Параметры

[in] Flags

Зарезервировано для последующего использования.

[in] TokenHandle

Дескриптор маркера клиента, используемого для инициализации параметра pAuthzClientContext . Маркер должен быть открыт с TOKEN_QUERY доступом.

[in] hAuthzResourceManager

Дескриптор диспетчера ресурсов, создавшего этот контекст клиента. Этот дескриптор хранится в структуре контекста клиента.

[in, optional] pExpirationTime

Дата и время окончания срока действия маркера. Если значение не передается, срок действия маркера никогда не истечет. Время истечения срока действия в настоящее время не применяется.

[in] Identifier

Идентификатор, относящееся к диспетчеру ресурсов. Этот параметр в настоящее время не используется.

[in, optional] DynamicGroupArgs

Указатель на параметры, передаваемые в функцию обратного вызова, которая вычисляет динамические группы.

[out] phAuthzClientContext

Указатель на возвращенный дескриптор AuthzClientContext . Вызовите AuthzFreeContext при выполнении с контекстом клиента.

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	authz.h
Библиотека	Authz.lib
DLL	Authz.dll
Распространяемые компоненты	Пакет средств администрирования Windows Server 2003 в Windows XP

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

AuthzFreeContext

Базовые функции контроль доступа