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

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	authz.h
Biblioteca	Authz.lib
DLL	Authz.dll
Redistribuível	Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP

Confira também

AuthzFreeContext

Funções básicas de Controle de Acesso