ReadProcessMemory

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function reads memory in a specified process. The entire area to be read must be accessible, or the operation fails.

BOOL ReadProcessMemory( HANDLE
hProcess
,
LPCVOID
lpBaseAddress
, LPVOID
lpBuffer
, DWORD
nSize
, LPDWORD
lpNumberOfBytesRead
);

Parameters

hProcess

Handle to the process whose memory is being read. In Windows CE, any call to OpenProcesswill return a process handle with the proper access rights.

lpBaseAddress

Pointer to the base address in the specified process to be read. Before any data transfer occurs, the system verifies that all data in the base address and memory of the specified size is accessible for read access. If this is the case, the function proceeds; otherwise, the function fails.

lpBuffer

Pointer to a buffer that receives the contents from the address space of the specified process.

nSize

Specifies the requested number of bytes to read from the specified process.

lpNumberOfBytesRead

Pointer to the actual number of bytes transferred into the specified buffer. If lpNumberOfBytesReadis NULL, the parameter is ignored.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

The function fails if the requested read operation crosses into an area of the process that is inaccessible.

Remarks

ReadProcessMemorycopies the data in the specified address range from the address space of the specified process into the specified buffer of the current process. The process whose address space is read is typically, but not necessarily, being debugged.

The entire area to be read must be accessible. If it is not, the function fails as noted previously.

Requirements

Runs On	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Winbase.h		Coredll.lib, Nk.lib

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.