mirror of
https://github.com/mirror/processhacker
synced 2026-06-08 16:03:24 +00:00
7bd28e4357
git-svn-id: svn://svn.code.sf.net/p/processhacker/code@2304 21ef857c-d57f-4fe0-8362-d861dc6d29cd
290 lines
8.1 KiB
C
290 lines
8.1 KiB
C
/*
|
|
* Process Hacker Library -
|
|
* KProcessHacker interface
|
|
*
|
|
* Copyright (C) 2009 wj32
|
|
*
|
|
* This file is part of Process Hacker.
|
|
*
|
|
* Process Hacker is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* Process Hacker is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with Process Hacker. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef _KPH_H
|
|
#define _KPH_H
|
|
|
|
#include "nph.h"
|
|
#include "nativedefs.h"
|
|
|
|
#define KPH_DEVICE_TYPE (0x9999)
|
|
#define KPH_DEVICE_NAME (L"\\\\.\\KProcessHacker")
|
|
|
|
#define KPHF_PSTERMINATEPROCESS 0x1
|
|
#define KPHF_PSPTERMINATETHREADBPYPOINTER 0x2
|
|
|
|
#define METHOD_BUFFERED 0
|
|
#define METHOD_IN_DIRECT 1
|
|
#define METHOD_OUT_DIRECT 2
|
|
#define METHOD_NEITHER 3
|
|
|
|
#ifndef FILE_ANY_ACCESS
|
|
#define FILE_ANY_ACCESS 0
|
|
#define FILE_SPECIAL_ACCESS (FILE_ANY_ACCESS)
|
|
#define FILE_READ_ACCESS (0x0001)
|
|
#define FILE_WRITE_ACCESS (0x0002)
|
|
#endif
|
|
|
|
#ifndef CTL_CODE
|
|
#define CTL_CODE(DeviceType, Function, Method, Access) ( \
|
|
((DeviceType) << 16) | ((Access) << 14) | ((Function) << 2) | (Method))
|
|
#define KPH_CTL_CODE(x) CTL_CODE(KPH_DEVICE_TYPE, 0x800 + x, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
#endif
|
|
|
|
#define KPH_READ KPH_CTL_CODE(0)
|
|
#define KPH_WRITE KPH_CTL_CODE(1)
|
|
#define KPH_GETFILEOBJECTNAME KPH_CTL_CODE(2)
|
|
#define KPH_OPENPROCESS KPH_CTL_CODE(3)
|
|
#define KPH_OPENTHREAD KPH_CTL_CODE(4)
|
|
#define KPH_OPENPROCESSTOKEN KPH_CTL_CODE(5)
|
|
#define KPH_GETPROCESSPROTECTED KPH_CTL_CODE(6)
|
|
#define KPH_SETPROCESSPROTECTED KPH_CTL_CODE(7)
|
|
#define KPH_TERMINATEPROCESS KPH_CTL_CODE(8)
|
|
#define KPH_SUSPENDPROCESS KPH_CTL_CODE(9)
|
|
#define KPH_RESUMEPROCESS KPH_CTL_CODE(10)
|
|
#define KPH_READVIRTUALMEMORY KPH_CTL_CODE(11)
|
|
#define KPH_WRITEVIRTUALMEMORY KPH_CTL_CODE(12)
|
|
#define KPH_SETPROCESSTOKEN KPH_CTL_CODE(13)
|
|
#define KPH_GETTHREADSTARTADDRESS KPH_CTL_CODE(14)
|
|
#define KPH_SETHANDLEATTRIBUTES KPH_CTL_CODE(15)
|
|
#define KPH_GETHANDLEOBJECTNAME KPH_CTL_CODE(16)
|
|
#define KPH_OPENPROCESSJOB KPH_CTL_CODE(17)
|
|
#define KPH_GETCONTEXTTHREAD KPH_CTL_CODE(18)
|
|
#define KPH_SETCONTEXTTHREAD KPH_CTL_CODE(19)
|
|
#define KPH_GETTHREADWIN32THREAD KPH_CTL_CODE(20)
|
|
#define KPH_DUPLICATEOBJECT KPH_CTL_CODE(21)
|
|
#define KPH_ZWQUERYOBJECT KPH_CTL_CODE(22)
|
|
#define KPH_GETPROCESSID KPH_CTL_CODE(23)
|
|
#define KPH_GETTHREADID KPH_CTL_CODE(24)
|
|
#define KPH_TERMINATETHREAD KPH_CTL_CODE(25)
|
|
#define KPH_GETFEATURES KPH_CTL_CODE(26)
|
|
#define KPH_SETHANDLEGRANTEDACCESS KPH_CTL_CODE(27)
|
|
#define KPH_ASSIGNIMPERSONATIONTOKEN KPH_CTL_CODE(28)
|
|
#define KPH_PROTECTADD KPH_CTL_CODE(29)
|
|
#define KPH_PROTECTREMOVE KPH_CTL_CODE(30)
|
|
#define KPH_PROTECTQUERY KPH_CTL_CODE(31)
|
|
#define KPH_UNSAFEREADVIRTUALMEMORY KPH_CTL_CODE(32)
|
|
#define KPH_SETEXECUTEOPTIONS KPH_CTL_CODE(33)
|
|
#define KPH_QUERYPROCESSHANDLES KPH_CTL_CODE(34)
|
|
#define KPH_OPENTHREADPROCESS KPH_CTL_CODE(35)
|
|
|
|
#ifndef MEM_EXECUTE_OPTION_DISABLE
|
|
#define MEM_EXECUTE_OPTION_DISABLE 0x1
|
|
#define MEM_EXECUTE_OPTION_ENABLE 0x2
|
|
#define MEM_EXECUTE_OPTION_DISABLE_THUNK_EMULATION 0x4
|
|
#define MEM_EXECUTE_OPTION_PERMANENT 0x8
|
|
#endif
|
|
|
|
typedef struct _PROCESS_HANDLE
|
|
{
|
|
HANDLE Handle;
|
|
PVOID Object;
|
|
ACCESS_MASK GrantedAccess;
|
|
ULONG HandleAttributes;
|
|
} PROCESS_HANDLE, *PPROCESS_HANDLE;
|
|
|
|
typedef struct _PROCESS_HANDLE_INFORMATION
|
|
{
|
|
ULONG HandleCount;
|
|
PROCESS_HANDLE Handles[1];
|
|
} PROCESS_HANDLE_INFORMATION, *PPROCESS_HANDLE_INFORMATION;
|
|
|
|
NTSTATUS PHAPI KphInit();
|
|
|
|
NPHAPI NTSTATUS PHAPI KphConnect(
|
|
__out PHANDLE KphHandle
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphDisconnect(
|
|
__in HANDLE KphHandle
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphGetFeatures(
|
|
__in HANDLE KphHandle,
|
|
__out PULONG Features
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphRead(
|
|
__in HANDLE KphHandle,
|
|
__in PVOID Address,
|
|
__out_bcount(BufferLength) PVOID Buffer,
|
|
__in ULONG BufferLength
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphWrite(
|
|
__in HANDLE KphHandle,
|
|
__in PVOID Address,
|
|
__in_bcount(Length) PVOID Buffer,
|
|
__in ULONG Length
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphOpenProcess(
|
|
__in HANDLE KphHandle,
|
|
__out PHANDLE ProcessHandle,
|
|
__in HANDLE ProcessId,
|
|
__in ACCESS_MASK DesiredAccess
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphOpenThread(
|
|
__in HANDLE KphHandle,
|
|
__out PHANDLE ThreadHandle,
|
|
__in HANDLE ThreadId,
|
|
__in ACCESS_MASK DesiredAccess
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphOpenProcessToken(
|
|
__in HANDLE KphHandle,
|
|
__out PHANDLE TokenHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__in ACCESS_MASK DesiredAccess
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphGetProcessProtected(
|
|
__in HANDLE KphHandle,
|
|
__in ULONG_PTR ProcessId,
|
|
__out PBOOLEAN IsProtected
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphSetProcessProtected(
|
|
__in HANDLE KphHandle,
|
|
__in ULONG_PTR ProcessId,
|
|
__in BOOLEAN IsProtected
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphTerminateProcess(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__in NTSTATUS ExitStatus
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphSuspendProcess(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphResumeProcess(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphReadVirtualMemory(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__in PVOID BaseAddress,
|
|
__out_bcount(BufferLength) PVOID Buffer,
|
|
__in ULONG BufferLength,
|
|
__out_opt PULONG ReturnLength
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphWriteVirtualMemory(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__in PVOID BaseAddress,
|
|
__in_bcount(BufferLength) PVOID Buffer,
|
|
__in ULONG BufferLength,
|
|
__out_opt PULONG ReturnLength
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphOpenProcessJob(
|
|
__in HANDLE KphHandle,
|
|
__out PHANDLE JobHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__in ACCESS_MASK DesiredAccess
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphGetContextThread(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ThreadHandle,
|
|
__inout PCONTEXT ThreadContext
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphSetContextThread(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ThreadHandle,
|
|
__in PCONTEXT ThreadContext
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphTerminateThread(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ThreadHandle,
|
|
__in NTSTATUS ExitStatus
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphSetHandleGrantedAccess(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE Handle,
|
|
__in ACCESS_MASK GrantedAccess
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphProtectAdd(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__in BOOLEAN AllowKernelMode,
|
|
__in ACCESS_MASK ProcessAllowMask,
|
|
__in ACCESS_MASK ThreadAllowMask
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphProtectRemove(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphProtectQuery(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__out PBOOLEAN AllowKernelMode,
|
|
__out PACCESS_MASK ProcessAllowMask,
|
|
__out PACCESS_MASK ThreadAllowMask
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphUnsafeReadVirtualMemory(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__in PVOID BaseAddress,
|
|
__in_bcount(BufferLength) PVOID Buffer,
|
|
__in ULONG BufferLength,
|
|
__out_opt PULONG ReturnLength
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphSetExecuteOptions(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__in ULONG ExecuteOptions
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphQueryProcessHandles(
|
|
__in HANDLE KphHandle,
|
|
__in HANDLE ProcessHandle,
|
|
__out_bcount_opt(BufferLength) PVOID Buffer,
|
|
__in_opt ULONG BufferLength,
|
|
__out_opt PULONG ReturnLength
|
|
);
|
|
|
|
NPHAPI NTSTATUS PHAPI KphOpenThreadProcess(
|
|
__in HANDLE KphHandle,
|
|
__out PHANDLE ProcessHandle,
|
|
__in HANDLE ThreadHandle,
|
|
__in ACCESS_MASK DesiredAccess
|
|
);
|
|
|
|
#endif
|