Voltar à lista
Windows Win32Segurança & tokensadvapi32.dll

AdjustTokenPrivileges

Habilita ou desabilita privilégios específicos em um token de acesso.

Descrição

Diferente das capabilities do Linux (concedidas na criação do processo ou via arquivo executável), privilégios do Windows são atribuídos ao token na criação da sessão de login mas ficam desabilitados por padrão — é preciso habilitá-los explicitamente antes de usá-los (ex.: SeDebugPrivilege antes de abrir processos protegidos).

Header: securitybaseapi.hDLL: advapi32.dllNative API: NtAdjustPrivilegesToken

Atenção

Retornar sucesso não garante que todos os privilégios pedidos foram concedidos — é preciso checar GetLastError separadamente para ERROR_NOT_ALL_ASSIGNED.

Assinatura

BOOL AdjustTokenPrivileges(
    HANDLE TokenHandle,
    BOOL DisableAllPrivileges,
    PTOKEN_PRIVILEGES NewState,
    DWORD BufferLength,
    PTOKEN_PRIVILEGES PreviousState,
    PDWORD ReturnLength
);

Parâmetros

ParâmetroTipoDescrição
TokenHandleHANDLEHandle do token, aberto com TOKEN_ADJUST_PRIVILEGES.
DisableAllPrivilegesBOOLSe TRUE, desabilita todos os privilégios (ignorando NewState).
NewStatePTOKEN_PRIVILEGESLista de privilégios a habilitar/desabilitar.
BufferLengthDWORDTamanho do buffer de estado anterior, se solicitado.
PreviousStatePTOKEN_PRIVILEGESSe não for NULL, recebe o estado anterior dos privilégios ajustados.
ReturnLengthPDWORDRecebe o tamanho real de `PreviousState`.

Valor de retorno

Diferente de zero em sucesso — inclusive quando nem todos os privilégios pedidos foram concedidos (checar GetLastError == ERROR_NOT_ALL_ASSIGNED); 0 em erro real.

Códigos de erro (GetLastError)

ERROR_NOT_ALL_ASSIGNED(1300)
Nem todos os privilégios ou grupos referenciados foram atribuídos ao chamador.
ERROR_ACCESS_DENIED(5)
Acesso negado.

Relacionadas

Equivalente em Linux x86_64

Linuxcapset

Mesma categoria

CheckTokenMembershipDecryptFileWDuplicateTokenExEncryptFileWGetFileSecurityWGetTokenInformationImpersonateLoggedOnUserInitializeSecurityDescriptor