Función VirtualProtect (memoryapi.h)

Artículo
02/07/2024

Cambia la protección en una región de páginas confirmadas en el espacio de direcciones virtuales del proceso de llamada.

Para cambiar la protección de acceso de cualquier proceso, use la función VirtualProtectEx .

Sintaxis

BOOL VirtualProtect(
  [in]  LPVOID lpAddress,
  [in]  SIZE_T dwSize,
  [in]  DWORD  flNewProtect,
  [out] PDWORD lpflOldProtect
);

Parámetros

[in] lpAddress

Dirección de la página inicial de la región de páginas cuyos atributos de protección de acceso se van a cambiar.

Todas las páginas de la región especificada deben estar dentro de la misma región reservada asignada al llamar a la función VirtualAlloc o VirtualAllocEx mediante MEM_RESERVE. Las páginas no pueden abarcar regiones reservadas adyacentes asignadas por llamadas independientes a VirtualAlloc o VirtualAllocEx mediante MEM_RESERVE.

[in] dwSize

Tamaño de la región cuyos atributos de protección de acceso se van a cambiar, en bytes. La región de las páginas afectadas incluye todas las páginas que contienen uno o más bytes en el intervalo desde el parámetro lpAddress a (lpAddress+dwSize). Esto significa que un intervalo de 2 bytes que coloca un límite de página hace que se cambien los atributos de protección de ambas páginas.

[in] flNewProtect

La opción de protección de memoria. Este parámetro puede ser una de las constantes de protección de memoria.

Para las vistas asignadas, este valor debe ser compatible con la protección de acceso especificada cuando se asignó la vista (vea MapViewOfFile, MapViewOfFileEx y MapViewOfFileExNuma).

[out] lpflOldProtect

Puntero a una variable que recibe el valor de protección de acceso anterior de la primera página de la región especificada de páginas. Si este parámetro es NULL o no apunta a una variable válida, se produce un error en la función.

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 cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Solo puede establecer el valor de protección de acceso en páginas confirmadas. Si el estado de cualquier página de la región especificada no se confirma, se produce un error en la función y devuelve sin modificar la protección de acceso de las páginas de la región especificada.

El modificador de protección PAGE_GUARD establece páginas de protección. Las páginas de protección actúan como alarmas de acceso de un solo disparo. Para obtener más información, vea Creating Guard Pages (Crear páginas de protección).

Es mejor evitar el uso de VirtualProtect para cambiar las protecciones de página en bloques de memoria asignados por GlobalAlloc, HeapAlloc o LocalAlloc, ya que pueden existir varios bloques de memoria en una sola página. El administrador del montón supone que todas las páginas del montón conceden al menos acceso de lectura y escritura.

Al proteger una región que será ejecutable, el programa de llamada asume la responsabilidad de garantizar la coherencia de la memoria caché a través de una llamada adecuada a FlushInstructionCache una vez establecido el código. De lo contrario, los intentos de ejecutar código fuera de la región recién ejecutable pueden producir resultados imprevisibles.

Requisitos


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