Toolhelp32ReadProcessMemory

This function copies memory allocated to another process into an application-supplied buffer.

BOOL WINAPI Toolhelp32ReadProcessMemory( 
DWORD th32ProcessID,
LPCVOID lpBaseAddress, 
LPVOID lpBuffer, 
DWORD cbRead, 
LPDWORD lpNumberOfBytesRead );

Parameters

  • th32ProcessID
    Identifier of the process whose memory is being copied. This parameter can be zero to copy the memory of the current process.
  • lpBaseAddress
    Base address in the specified process to read. Before transferring any data, 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 of the address space of the specified process.
  • cbRead
    Number of bytes to read from the specified process.
  • lpNumberOfBytesRead
    Pointer to the number of bytes copied to the specified buffer. If this parameter is NULL, it is ignored.

Return Values

TRUE indicates success. FALSE indicates failure.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Tlhelp32.h    

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.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.