Freigeben über


Toolhelp32ReadProcessMemory-Funktion (tlhelp32.h)

Kopiert arbeitsspeicher, der einem anderen Prozess zugeordnet ist, in einen von der Anwendung bereitgestellten Puffer.

Syntax

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

Parameter

[in] th32ProcessID

Der Bezeichner des Prozesses, dessen Arbeitsspeicher kopiert wird. Dieser Parameter kann null sein, um den Arbeitsspeicher des aktuellen Prozesses zu kopieren.

[in] lpBaseAddress

Die Basisadresse im angegebenen Prozess, der gelesen werden soll. Vor der Übertragung von Daten überprüft das System, dass alle Daten in der Basisadresse und im Arbeitsspeicher der angegebenen Größe für den Lesezugriff zugänglich sind. Wenn dies der Fall ist, wird die Funktion fortgesetzt. Andernfalls schlägt die Funktion fehl.

[out] lpBuffer

Ein Zeiger auf einen Puffer, der den Inhalt des Adressraums des angegebenen Prozesses empfängt.

[in] cbRead

Die Anzahl der Bytes, die aus dem angegebenen Prozess gelesen werden sollen.

[out] lpNumberOfBytesRead

Die Anzahl der Bytes, die in den angegebenen Puffer kopiert wurden. Wenn dieser Parameter NULL ist, wird er ignoriert.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war.

Hinweise

Diese Funktion öffnet ein Handle für den Zielprozess und schließt es, sobald der Lesevorgang abgeschlossen ist. Wenn Sie mehrere Lesevorgänge ausführen möchten, verwenden Sie stattdessen ReadProcessMemory .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile tlhelp32.h
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Process32First

Process32Weiter

Toolhilfefunktionen