process.c File Reference

#include "umandlg.h"

Include dependency graph for process.c:

Go to the source code of this file.

Functions
DWORD	GetProcessID (IN LPCWSTR lpszProcessName)
BOOL	IsProcessRunning (IN LPCWSTR lpszProcessName)
BOOL	LaunchProcess (IN LPCWSTR lpszProcessName)
BOOL	CloseProcess (IN LPCWSTR lpszProcessName)

Function Documentation

CloseProcess()

BOOL CloseProcess

(

IN LPCWSTR

lpszProcessName

)

@CloseProcess

Closes a process.

Parameters

[in]

lpszProcessName

The name of the executable process.

Returns

Returns TRUE if the process has been terminated successfully, FALSE otherwise.

Definition at line 192 of file process.c.

{
    HANDLE hProcess;
    DWORD dwProcessID;
 
    /* Get the process ID */
    dwProcessID = GetProcessID(lpszProcessName);
    if (dwProcessID == 0)
    {
        return FALSE;
    }
 
    /* Make sure that the given process ID is not ours, the parent process, so that we do not kill ourselves */
    if (dwProcessID == GetCurrentProcessId())
    {
        return FALSE;
    }
 
    /* Open the process so that we can terminate it */
    hProcess = OpenProcess(PROCESS_TERMINATE, FALSE, dwProcessID);
    if (!hProcess)
    {
        DPRINT("CloseProcess(): Failed to open the process for termination! (Error: %lu)\n", GetLastError());
        return FALSE;
    }
 
    /* Terminate it */
    TerminateProcess(hProcess, 0);
    CloseHandle(hProcess);
    return TRUE;
}

Referenced by DlgProc().

GetProcessID()

DWORD GetProcessID

(

IN LPCWSTR

lpszProcessName

)

@GetProcessID

Returns the process executable ID based on the given executable name.

Parameters

[in]

lpszProcessName

The name of the executable process.

Returns

Returns the ID number of the process, otherwise 0.

Definition at line 26 of file process.c.

{
    PROCESSENTRY32W Process;
 
    /* Create a snapshot and check if the given process name matches with the one from the process entry structure */
    HANDLE hSnapshot = CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS, 0);
 
    if (hSnapshot == INVALID_HANDLE_VALUE)
        return 0;
 
    /* Get the whole size of the structure */
    Process.dwSize = sizeof(Process);
 
    /* Enumerate the processes */
    if (Process32FirstW(hSnapshot, &Process))
    {
        do
        {
            if (_wcsicmp(Process.szExeFile, lpszProcessName) == 0)
            {
                /* The names match, return the process ID we're interested */
                CloseHandle(hSnapshot);
                return Process.th32ProcessID;
            }
        }
        while (Process32NextW(hSnapshot, &Process));
    }
 
    CloseHandle(hSnapshot);
    return 0;
}

Referenced by CloseProcess(), and IsProcessRunning().

IsProcessRunning()

BOOL IsProcessRunning

(

IN LPCWSTR

lpszProcessName

)

@IsProcessRunning

Checks if a process is running.

Parameters

[in]

lpszProcessName

The name of the executable process.

Returns

Returns TRUE if the given process' name is running, FALSE otherwise.

Definition at line 71 of file process.c.

{
    DWORD dwReturn, dwProcessID;
    HANDLE hProcess;
 
    /* Get the process ID */
    dwProcessID = GetProcessID(lpszProcessName);
    if (dwProcessID == 0)
    {
        return FALSE;
    }
 
    /* Synchronize the process to get its signaling state */
    hProcess = OpenProcess(SYNCHRONIZE, FALSE, dwProcessID);
    if (!hProcess)
    {
        DPRINT("IsProcessRunning(): Failed to open the process! (Error: %lu)\n", GetLastError());
        return FALSE;
    }
 
    /* Wait for the process */
    dwReturn = WaitForSingleObject(hProcess, 0);
    if (dwReturn == WAIT_TIMEOUT)
    {
        /* The process is still running */
        CloseHandle(hProcess);
        return TRUE;
    }
 
    CloseHandle(hProcess);
    return FALSE;
}

Referenced by InitUtilsList(), and ListBoxRefreshContents().

LaunchProcess()

BOOL LaunchProcess

(

IN LPCWSTR

lpszProcessName

)

@LaunchProcess

Executes a process.

Parameters

[in]

lpProcessName

The name of the executable process.

Returns

Returns TRUE if the process has been launched successfully, FALSE otherwise.

Definition at line 117 of file process.c.

{
    STARTUPINFOW si;
    PROCESS_INFORMATION pi;
    HANDLE hUserToken, hProcessToken;
    BOOL bSuccess;
    WCHAR ExpandedCmdLine[MAX_PATH];
 
    /* Expand the process path string */
    ExpandEnvironmentStringsW(lpszProcessName, ExpandedCmdLine, ARRAYSIZE(ExpandedCmdLine));
 
    ZeroMemory(&pi, sizeof(pi));
    ZeroMemory(&si, sizeof(si));
    si.cb = sizeof(si);
    si.dwFlags = STARTF_USESHOWWINDOW;
    si.wShowWindow = SW_SHOWNORMAL;
 
    /* Get the token of the parent (current) process of the application */
    bSuccess = OpenProcessToken(GetCurrentProcess(), TOKEN_QUERY | TOKEN_DUPLICATE, &hUserToken);
    if (!bSuccess)
    {
        DPRINT("OpenProcessToken() failed with error -> %lu\n", GetLastError());
        return FALSE;
    }
 
    /* Duplicate a new token so that we can use it to create our process */
    bSuccess = DuplicateTokenEx(hUserToken, TOKEN_ALL_ACCESS, NULL, SecurityIdentification, TokenPrimary, &hProcessToken);
    if (!bSuccess)
    {
        DPRINT("DuplicateTokenEx() failed with error -> %lu\n", GetLastError());
        CloseHandle(hUserToken);
        return FALSE;
    }
 
    /* Finally create the process */
    bSuccess = CreateProcessAsUserW(hProcessToken,
                                    NULL,
                                    ExpandedCmdLine,
                                    NULL,
                                    NULL,
                                    FALSE,
                                    0, // DETACHED_PROCESS, NORMAL_PRIORITY_CLASS
                                    NULL,
                                    NULL,
                                    &si,
                                    &pi);
 
    if (!bSuccess)
    {
        DPRINT("CreateProcessAsUserW() failed with error -> %lu\n", GetLastError());
        CloseHandle(hUserToken);
        CloseHandle(hProcessToken);
        return FALSE;
    }
 
    CloseHandle(pi.hProcess);
    CloseHandle(pi.hThread);
    CloseHandle(hUserToken);
    CloseHandle(hProcessToken);
    return TRUE;
}

Referenced by DlgProc().