Função AuthzInitializeContextFromToken (authz.h)

A função AuthzInitializeContextFromToken inicializa um contexto de autorização do cliente de um token de kernel. O token de kernel deve ter sido aberto para TOKEN_QUERY.

Começando com Windows Server 2012 e Windows 8, essa função também pode copiar grupos de dispositivos, declarações de usuário e declarações de dispositivo.

Sintaxe

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
);

Parâmetros

[in] Flags

Reservado para uso futuro.

[in] TokenHandle

Um identificador para o token de cliente usado para inicializar o parâmetro pAuthzClientContext . O token deve ter sido aberto com acesso TOKEN_QUERY.

[in] hAuthzResourceManager

Um identificador para o gerenciador de recursos que criou esse contexto de cliente. Esse identificador é armazenado na estrutura de contexto do cliente.

[in, optional] pExpirationTime

Data e hora de validade do token. Se nenhum valor for passado, o token nunca expirará. O tempo de expiração não é imposto no momento.

[in] Identifier

Identificador específico do gerenciador de recursos. Esse parâmetro não é usado no momento.

[in, optional] DynamicGroupArgs

Um ponteiro para parâmetros a serem passados para a função de retorno de chamada que computa grupos dinâmicos.

[out] phAuthzClientContext

Um ponteiro para o identificador AuthzClientContext retornado. Chame AuthzFreeContext quando terminar com o contexto do cliente.

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função chama a função de retorno de chamada AuthzComputeGroupsCallback para adicionar identificadores de segurança ao contexto recém-criado.

Requisitos

Confira também

AuthzFreeContext

Funções básicas de Controle de Acesso