Função OpenProcessToken (processthreadsapi.h)

Artigo
03/01/2024

A função OpenProcessToken abre o token de acesso associado a um processo.

Sintaxe

BOOL OpenProcessToken(
  [in]  HANDLE  ProcessHandle,
  [in]  DWORD   DesiredAccess,
  [out] PHANDLE TokenHandle
);

Parâmetros

[in] ProcessHandle

Um identificador para o processo cujo token de acesso é aberto. O processo deve ter a permissão de acesso PROCESS_QUERY_LIMITED_INFORMATION. Confira Segurança do processo e Direitos de Acesso para obter mais informações.

[in] DesiredAccess

Especifica uma máscara de acesso que especifica os tipos de acesso solicitados ao token de acesso. Esses tipos de acesso solicitados são comparados com a DACL ( lista de controle de acesso discricionário ) do token para determinar quais acessos são concedidos ou negados.

Para obter uma lista de direitos de acesso para tokens de acesso, consulte Direitos de acesso para objetos Access-Token.

[out] TokenHandle

Um ponteiro para um identificador que identifica o token de acesso recém-aberto quando a função retorna.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para obter um identificador para um processo elevado de dentro de um processo não elevado, ambos os processos devem ser iniciados da mesma conta.

Se o processo que está sendo verificado tiver sido iniciado por uma conta diferente, o processo de verificação precisará ter o privilégio de SE_DEBUG_NAME habilitado. Consulte Constantes de privilégio (autorização) para obter mais informações.

Para fechar o identificador de token de acesso retornado por meio do parâmetro TokenHandle , chame CloseHandle.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	processthreadsapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll