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 |