Skip to content

Commit 272f3d8

Browse files
KN4CK3RKN4CK3R
committed
Sync with ReClass.NET changes.
1 parent 18e4b8c commit 272f3d8

File tree

3 files changed

+137
-29
lines changed

3 files changed

+137
-29
lines changed

‎Native/SamplePlugin.vcxproj

+4
Original file line numberDiff line numberDiff line change
@@ -74,21 +74,25 @@
7474
<LinkIncremental>true</LinkIncremental>
7575
<TargetName>$(ProjectName)</TargetName>
7676
<OutDir>$(SolutionDir)bin\$(Configuration)\</OutDir>
77+
<IncludePath>..\..\ReClass.NET\NativeCore;$(IncludePath)</IncludePath>
7778
</PropertyGroup>
7879
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
7980
<LinkIncremental>true</LinkIncremental>
8081
<TargetName>$(ProjectName)</TargetName>
8182
<OutDir>$(SolutionDir)bin\$(Configuration)\x64\</OutDir>
83+
<IncludePath>..\..\ReClass.NET\NativeCore;$(IncludePath)</IncludePath>
8284
</PropertyGroup>
8385
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
8486
<LinkIncremental>false</LinkIncremental>
8587
<TargetName>$(ProjectName)</TargetName>
8688
<OutDir>$(SolutionDir)bin\$(Configuration)\</OutDir>
89+
<IncludePath>..\..\ReClass.NET\NativeCore;$(IncludePath)</IncludePath>
8790
</PropertyGroup>
8891
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'">
8992
<LinkIncremental>false</LinkIncremental>
9093
<TargetName>$(ProjectName)</TargetName>
9194
<OutDir>$(SolutionDir)bin\$(Configuration)\x64\</OutDir>
95+
<IncludePath>..\..\ReClass.NET\NativeCore;$(IncludePath)</IncludePath>
9296
</PropertyGroup>
9397
<ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
9498
<ClCompile>

‎Native/dllmain.cpp

+120-27
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,134 @@
11
#include <windows.h>
22
#include <cstdint>
33

4-
enum class RequestFunction
4+
#include <ReClassNET_Plugin.hpp>
5+
6+
/// <summary>Enumerate all processes on the system.</summary>
7+
/// <param name="callbackProcess">The callback for a process.</param>
8+
void __stdcall EnumerateProcesses(EnumerateProcessCallback callbackProcess)
9+
{
10+
// Enumerate all processes with the current plattform (x86/x64) and call the callback.
11+
}
12+
13+
/// <summary>Enumerate all sections and modules of the remote process.</summary>
14+
/// <param name="process">The process handle obtained by OpenRemoteProcess.</param>
15+
/// <param name="callbackSection">The callback for a section.</param>
16+
/// <param name="callbackModule">The callback for a module.</param>
17+
void __stdcall EnumerateRemoteSectionsAndModules(RC_Pointer handle, EnumerateRemoteSectionsCallback callbackSection, EnumerateRemoteModulesCallback callbackModule)
18+
{
19+
// Enumerate all sections and modules of the remote process and call the callback for them.
20+
}
21+
22+
/// <summary>Opens the remote process.</summary>
23+
/// <param name="id">The identifier of the process returned by EnumerateProcesses.</param>
24+
/// <param name="desiredAccess">The desired access.</param>
25+
/// <returns>A handle to the remote process or nullptr if an error occured.</returns>
26+
RC_Pointer __stdcall OpenRemoteProcess(RC_Pointer id, ProcessAccess desiredAccess)
27+
{
28+
// Open the remote process with the desired access rights and return the handle to use with the other functions.
29+
30+
return nullptr;
31+
}
32+
33+
/// <summary>Queries if the process is valid.</summary>
34+
/// <param name="handle">The process handle obtained by OpenRemoteProcess.</param>
35+
/// <returns>True if the process is valid, false if not.</returns>
36+
bool __stdcall IsProcessValid(RC_Pointer handle)
37+
{
38+
// Check if the handle is valid.
39+
40+
return false;
41+
}
42+
43+
/// <summary>Closes the handle to the remote process.</summary>
44+
/// <param name="handle">The process handle obtained by OpenRemoteProcess.</param>
45+
void __stdcall CloseRemoteProcess(RC_Pointer handle)
46+
{
47+
// Close the handle to the remote process.
48+
}
49+
50+
/// <summary>Reads memory of the remote process.</summary>
51+
/// <param name="handle">The process handle obtained by OpenRemoteProcess.</param>
52+
/// <param name="address">The address to read from.</param>
53+
/// <param name="buffer">The buffer to read into.</param>
54+
/// <param name="offset">The offset into the buffer.</param>
55+
/// <param name="size">The number of bytes to read.</param>
56+
/// <returns>True if it succeeds, false if it fails.</returns>
57+
bool __stdcall ReadRemoteMemory(RC_Pointer handle, RC_Pointer address, RC_Pointer buffer, int offset, int size)
558
{
6-
IsProcessValid,
7-
OpenRemoteProcess,
8-
CloseRemoteProcess,
9-
ReadRemoteMemory,
10-
WriteRemoteMemory,
11-
EnumerateProcesses,
12-
EnumerateRemoteSectionsAndModules,
13-
DisassembleRemoteCode,
14-
ControlRemoteProcess
15-
};
59+
// Read the memory of the remote process into the buffer.
1660

17-
typedef LPVOID(__stdcall *RequestFunctionPtrCallback)(RequestFunction request);
18-
RequestFunctionPtrCallback requestFunction;
61+
return false;
62+
}
1963

20-
/// <summary>This method gets called when ReClass.NET loads the plugin.</summary>
21-
VOID __stdcall Initialize(RequestFunctionPtrCallback requestCallback)
64+
/// <summary>Writes memory to the remote process.</summary>
65+
/// <param name="process">The process handle obtained by OpenRemoteProcess.</param>
66+
/// <param name="address">The address to write to.</param>
67+
/// <param name="buffer">The buffer to write.</param>
68+
/// <param name="offset">The offset into the buffer.</param>
69+
/// <param name="size">The number of bytes to write.</param>
70+
/// <returns>True if it succeeds, false if it fails.</returns>
71+
bool __stdcall WriteRemoteMemory(RC_Pointer handle, RC_Pointer address, RC_Pointer buffer, int offset, int size)
2272
{
23-
requestFunction = requestCallback;
73+
// Write the buffer into the memory of the remote process.
2474

25-
// Use requestFunction to get a function pointer from ReClass.NET to call the desired function.
26-
//auto isProcessValid = static_cast<BOOL(__stdcall*)(HANDLE process)>(requestFunction(RequestFunction::IsProcessValid));
27-
//if (isProcessValid(handle)) { ... }
75+
return false;
76+
}
77+
78+
/// <summary>Control the remote process (Pause, Resume, Terminate).</summary>
79+
/// <param name="handle">The process handle obtained by OpenRemoteProcess.</param>
80+
/// <param name="action">The action to perform.</param>
81+
void __stdcall ControlRemoteProcess(RC_Pointer handle, ControlRemoteProcessAction action)
82+
{
83+
// Perform the desired action on the remote process.
2884
}
2985

30-
/// <summary>This function doesn't read memory but fills the buffer with 0-4.</summary>
31-
BOOL __stdcall ReadRemoteMemory(HANDLE process, LPCVOID address, LPVOID buffer, SIZE_T size)
86+
/// <summary>Attach a debugger to the process.</summary>
87+
/// <param name="id">The identifier of the process returned by EnumerateProcesses.</param>
88+
/// <returns>True if it succeeds, false if it fails.</returns>
89+
bool __stdcall AttachDebuggerToProcess(RC_Pointer id)
3290
{
33-
auto data = static_cast<uint8_t*>(buffer);
91+
// Attach a debugger to the remote process.
3492

35-
for (auto i = 0u; i < size; ++i)
36-
{
37-
data[i] = i % 5;
38-
}
93+
return false;
94+
}
95+
96+
/// <summary>Detach a debugger from the remote process.</summary>
97+
/// <param name="id">The identifier of the process returned by EnumerateProcesses.</param>
98+
void __stdcall DetachDebuggerFromProcess(RC_Pointer id)
99+
{
100+
// Detach the debugger.
101+
}
102+
103+
/// <summary>Wait for a debug event within the given timeout.</summary>
104+
/// <param name="evt">[out] The occured debug event.</param>
105+
/// <param name="timeoutInMilliseconds">The timeout in milliseconds.</param>
106+
/// <returns>True if an event occured within the given timeout, false if not.</returns>
107+
bool __stdcall AwaitDebugEvent(DebugEvent* evt, int timeoutInMilliseconds)
108+
{
109+
// Wait for a debug event.
110+
111+
return false;
112+
}
113+
114+
/// <summary>Handles the debug event described by evt.</summary>
115+
/// <param name="evt">[in] The (modified) event returned by AwaitDebugEvent.</param>
116+
void __stdcall HandleDebugEvent(DebugEvent* evt)
117+
{
118+
// Handle the debug event.
119+
}
120+
121+
/// <summary>Sets a hardware breakpoint.</summary>
122+
/// <param name="processId">The identifier of the process returned by EnumerateProcesses.</param>
123+
/// <param name="address">The address of the breakpoint.</param>
124+
/// <param name="reg">The register to use.</param>
125+
/// <param name="type">The type of the breakpoint.</param>
126+
/// <param name="size">The size of the breakpoint.</param>
127+
/// <param name="set">True to set the breakpoint, false to remove it.</param>
128+
/// <returns>True if it succeeds, false if it fails.</returns>
129+
bool __stdcall SetHardwareBreakpoint(RC_Pointer id, RC_Pointer address, HardwareBreakpointRegister reg, HardwareBreakpointTrigger type, HardwareBreakpointSize size, bool set)
130+
{
131+
// Set a hardware breakpoint with the given parameters.
39132

40-
return TRUE;
133+
return false;
41134
}

‎Native/exports.def

+13-2
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,15 @@
11
LIBRARY
22
EXPORTS
3-
Initialize
4-
ReadRemoteMemory
3+
IsProcessValid
4+
OpenRemoteProcess
5+
CloseRemoteProcess
6+
ReadRemoteMemory
7+
WriteRemoteMemory
8+
EnumerateProcesses
9+
EnumerateRemoteSectionsAndModules
10+
ControlRemoteProcess
11+
AttachDebuggerToProcess
12+
DetachDebuggerFromProcess
13+
AwaitDebugEvent
14+
HandleDebugEvent
15+
SetHardwareBreakpoint

0 commit comments

Comments
 (0)