ReadProcessMemory

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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

Parameters

  • hProcess
    [in] Handle to the process whose memory is being read. In Windows Embedded CE, any call to OpenProcess returns a process handle with the proper access rights.
  • lpBaseAddress
    [in] Pointer to the base address in the specified process to be read.

    Before 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 so, the function proceeds; otherwise, the function fails.

  • lpBuffer
    [out] Pointer to a buffer that receives the contents from the address space of the specified process.
  • nSize
    [in] Specifies the requested number of bytes to read from the specified process.
  • lpNumberOfBytesRead
    [out] Pointer to the number of bytes transferred into the specified buffer.

    If lpNumberOfBytesRead is NULL, the parameter is ignored.

Return Value

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

ReadProcessMemory copies 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.

Requirements

Header winbase.h
Library coredll.lib, Nk.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Process and Thread Functions
OpenProcess
WriteProcessMemory