windows-privilege.c File Reference

Implementation of Windows only APIs for adjusting privileges. More...

#include "pch.h"

Functions
BOOLEAN	WindowsSetDebugPrivilege ()
	Adjust kernel debug privilege.

Variables
BOOLEAN	g_PrivilegesAlreadyAdjusted = FALSE
	Is privileges already adjusted.

Detailed Description

Implementation of 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
}

Variable Documentation

g_PrivilegesAlreadyAdjusted

BOOLEAN g_PrivilegesAlreadyAdjusted = FALSE

Is privileges already adjusted.