ReadProcessMemory

9/8/2008

Esta função lê memória em um processo especificado. A área inteira seja ler deve ser acessível ou a operação falhará.

Syntax

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

Parameters

• hProcess
  [no] Identificador para o processo cuja memória está sendo ler. Windows Embedded CE, qualquer chamar para OpenProcess retorna um identificador processo com os direitos acessar adequado.

• lpBaseAddress
  [no] Ponteiro para o endereço de base no processo especificado seja ler.

  Antes de transferência de dados ocorrer, o sistema verifica se todos os dados no endereço de base e memória do tamanho especificado está acessível para ler acessar. Se assim, a função continua; caso contrário, o função falhar.

• lpBuffer
  [out] Ponteiro para uma reserva que recebe o conteúdo a partir de espaço de endereço do processo especificado.

• nTamanho
  [no] Especifica o número solicitado de bytes para ler a partir de processo especificado.

• lpNumberOfBytesRead
  [out] Ponteiro para o número de bytes transferidos para a reserva especificada.

  Se lpNumberOfBytesRead é NULL, o parâmetro será ignorado.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

A função falhará se o operação de leitura solicitada cruza em uma área do processo que está inacessível.

Remarks

ReadProcessMemory Copia dados na intervalo do endereço especificado a partir de espaço de endereço do processo especificado para a reserva especificada do atual processo. O processo cujo espaço de endereço é ler é geralmente, mas não necessariamente, que está sendo depurado.

A área inteira seja ler deve estar acessível. Se não for o função falhar.

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