Compartilhar via


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. 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

Confira também

Controle de acesso

Funções básicas de Controle de Acesso

AccessCheck

AdjustTokenGroups

AdjustTokenPrivileges

CloseHandle

GetCurrentProcessToken

GetCurrentThreadEffectiveToken

GetCurrentThreadToken

GetTokenInformation

Openthreadtoken

SetTokenInformation