Partager via


Fonction Toolhelp32ReadProcessMemory (tlhelp32.h)

Copie la mémoire allouée à un autre processus dans une mémoire tampon fournie par l’application.

Syntaxe

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

Paramètres

[in] th32ProcessID

Identificateur du processus dont la mémoire est copiée. Ce paramètre peut être égal à zéro pour copier la mémoire du processus actuel.

[in] lpBaseAddress

Adresse de base dans le processus spécifié à lire. Avant de transférer des données, le système vérifie que toutes les données de l’adresse de base et de la mémoire de la taille spécifiée sont accessibles en lecture. Si tel est le cas, la fonction continue. Sinon, la fonction échoue.

[out] lpBuffer

Pointeur vers une mémoire tampon qui reçoit le contenu de l’espace d’adressage du processus spécifié.

[in] cbRead

Nombre d’octets à lire à partir du processus spécifié.

[out] lpNumberOfBytesRead

Nombre d’octets copiés dans la mémoire tampon spécifiée. Si ce paramètre a la valeur NULL, il est ignoré.

Valeur retournée

Retourne TRUE en cas de réussite.

Remarques

Cette fonction ouvre un handle au processus cible et le ferme une fois l’opération de lecture terminée. Si vous envisagez d’effectuer plusieurs lectures, utilisez plutôt ReadProcessMemory .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête tlhelp32.h
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

Process32First

Process32Next

Fonctions d’aide de l’outil