Compartilhar via


Função Toolhelp32ReadProcessMemory (tlhelp32.h)

Copia a memória alocada para outro processo em um buffer fornecido pelo aplicativo.

Sintaxe

BOOL Toolhelp32ReadProcessMemory(
  [in]  DWORD   th32ProcessID,
  [in]  LPCVOID lpBaseAddress,
  [out] LPVOID  lpBuffer,
  [in]  SIZE_T  cbRead,
  [out] SIZE_T  *lpNumberOfBytesRead
);

Parâmetros

[in] th32ProcessID

O identificador do processo cuja memória está sendo copiada. Esse parâmetro pode ser zero para copiar a memória do processo atual.

[in] lpBaseAddress

O endereço base no processo especificado a ser lido. Antes de transferir dados, o sistema verifica se todos os dados no endereço base e na memória do tamanho especificado estão acessíveis para acesso de leitura. Se esse for o caso, a função continuará. Caso contrário, a função falhará.

[out] lpBuffer

Um ponteiro para um buffer que recebe o conteúdo do espaço de endereço do processo especificado.

[in] cbRead

O número de bytes a serem lidos do processo especificado.

[out] lpNumberOfBytesRead

O número de bytes copiados para o buffer especificado. Se esse parâmetro for NULL, ele será ignorado.

Retornar valor

Retorna TRUE se tiver êxito.

Comentários

Essa função abre um identificador para o processo de destino e o fecha depois que a operação de leitura é concluída. Se você estiver planejando executar várias leituras, use ReadProcessMemory .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho tlhelp32.h
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Process32First

Process32Next

Funções de Ajuda da Ferramenta