Função OpenProcessToken (processthreadsapi.h)

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. Consulte 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 solicitados de acesso 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 a partir da mesma conta.

Se o processo que está sendo verificado foi iniciado por uma conta diferente, o processo de verificação precisa ter o privilégio SE_DEBUG_NAME habilitado. Consulte As Constantes de Privilégios (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

   
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

Confira também

Controle de acesso

Funções básicas de Controle de Acesso

AccessCheck

AdjustTokenGroups

AdjustTokenPrivileges

CloseHandle

GetCurrentProcessToken

GetCurrentThreadEffectiveToken

GetCurrentThreadToken

GetTokenInformation

Openthreadtoken

SetTokenInformation