Compartir a través de

Función ReadProcessMemory (memoryapi.h)

  • Artículo

Sintaxis

BOOL ReadProcessMemory(
  [in]  HANDLE  hProcess,
  [in]  LPCVOID lpBaseAddress,
  [out] LPVOID  lpBuffer,
  [in]  SIZE_T  nSize,
  [out] SIZE_T  *lpNumberOfBytesRead
);

Parámetros

[in] hProcess

Identificador del proceso con memoria que se está leyendo. El identificador debe tener PROCESS_VM_READ acceso al proceso.

[in] lpBaseAddress

Puntero a la dirección base del proceso especificado desde el que se va a leer. Antes de que se produzca cualquier transferencia de datos, el sistema comprueba que todos los datos de la dirección base y la memoria del tamaño especificado son accesibles para el acceso de lectura y, si no es accesible, se produce un error en la función.

[out] lpBuffer

Puntero a un búfer que recibe el contenido del espacio de direcciones del proceso especificado.

[in] nSize

Número de bytes que se van a leer del proceso especificado.

[out] lpNumberOfBytesRead

Puntero a una variable que recibe el número de bytes transferidos al búfer especificado. Si lpNumberOfBytesRead es NULL, se omite el parámetro .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es 0 (cero). Para obtener información de error extendida, llame a GetLastError.

Se produce un error en la función si la operación de lectura solicitada se cruza en un área del proceso que no es accesible.

Comentarios

ReadProcessMemory copia los datos en el intervalo de direcciones especificado desde el espacio de direcciones del proceso especificado en el búfer especificado del proceso actual. Cualquier proceso que tenga un identificador con PROCESS_VM_READ acceso puede llamar a la función .

Todo el área que se va a leer debe ser accesible y, si no es accesible, se produce un error en la función.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado memoryapi.h (incluye Windows.h)
Library onecore.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de depuración, OpenProcess, Funciones de proceso para depuración, VirtualAllocEx, WriteProcessMemory