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

Функция 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.

Комментарии

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

Требования

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

AuthzFreeContext

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