windows-privilege.h File Reference

Windows only APIs for adjusting privileges. More...

Go to the source code of this file.

Functions
BOOLEAN	WindowsSetDebugPrivilege ()
	Adjust kernel debug privilege.

Detailed Description

Windows only APIs for adjusting privileges.

Author

Sina Karvandi (sina@.nosp@m.hype.nosp@m.rdbg..nosp@m.org)

Version

0.19

Date

2026-05-28

Copyright

This project is released under the GNU Public License v3.

Function Documentation

WindowsSetDebugPrivilege()

BOOLEAN WindowsSetDebugPrivilege

(

)

Adjust kernel debug privilege.

Returns

BOOLEAN return TRUE if it was successful or FALSE if there

{
#ifdef _WIN32 // Windows
    BOOL   Status;
    HANDLE Token;
 
    //
    // Check if we already adjusted the privilege
    //
    if (g_PrivilegesAlreadyAdjusted)
    {
        return TRUE;
    }
 
    //
    // Enable Debug privilege
    //
    Status = OpenProcessToken(GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES, &Token);
    if (!Status)
    {
        ShowMessages("err, OpenProcessToken failed (%x)\n", GetLastError());
        return FALSE;
    }
 
    Status = SetPrivilege(Token, SE_DEBUG_NAME, TRUE);
    if (!Status)
    {
        CloseHandle(Token);
        return FALSE;
    }
 
    //
    // Indicate that the privilege is already adjusted
    //
    g_PrivilegesAlreadyAdjusted = TRUE;
 
    CloseHandle(Token);
    return TRUE;
 
#elif defined(__linux__) // Linux
    return TRUE; // No need to adjust privileges on Linux
#endif
}