Voltar à lista
Windows Win32Segurança & tokensadvapi32.dll

OpenProcessToken

Abre o token de acesso associado a um processo, usado para consultar/ajustar seus privilégios e identidade.

Descrição

O token de acesso é o equivalente Windows mais próximo do conjunto UID/GID/capabilities de um processo Linux, mas unificado em um único objeto que também carrega grupos, privilégios (SeDebugPrivilege, SeShutdownPrivilege, ...) e nível de integridade.

Header: processthreadsapi.hDLL: advapi32.dllNative API: NtOpenProcessToken

Assinatura

BOOL OpenProcessToken(
    HANDLE ProcessHandle,
    DWORD DesiredAccess,
    PHANDLE TokenHandle
);

Parâmetros

ParâmetroTipoDescrição
ProcessHandleHANDLEHandle do processo.
DesiredAccessDWORDTOKEN_QUERY, TOKEN_ADJUST_PRIVILEGES, etc.
TokenHandlePHANDLERecebe o handle do token.

Valor de retorno

Diferente de zero em sucesso; 0 em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_ACCESS_DENIED(5)
Acesso negado.
ERROR_INVALID_HANDLE(6)
O identificador (handle) informado é inválido.

Relacionadas

Mesma categoria

AdjustTokenPrivilegesCheckTokenMembershipDecryptFileWDuplicateTokenExEncryptFileWGetFileSecurityWGetTokenInformationImpersonateLoggedOnUser