На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

VirtualProtect



The VirtualProtect function changes the access protection on a region of committed pages in the virtual address space of the calling process. This function differs from VirtualProtectEx, which changes the access protection of any process.

BOOL VirtualProtect(

LPVOID lpAddress, // address of region of committed pages
DWORD dwSize, // size of the region
DWORD flNewProtect, // desired access protection
PDWORD lpflOldProtect // address of variable to get old protection
);


Parameters

lpAddress

Points to the base address of the region of pages whose access protection attributes are to be changed.
All pages in the specified region must have been allocated in a single call to the VirtualAlloc or VirtualAllocEx function. The pages cannot span adjacent regions that were allocated by separate calls to VirtualAlloc or VirtualAllocEx.

dwSize

Specifies the size, in bytes, of the region whose access protection attributes are to be changed. The region of affected pages includes all pages containing one or more bytes in the range from the lpAddress parameter to (lpAddress+dwSize). This means that a 2-byte range straddling a page boundary causes the protection attributes of both pages to be changed.

flNewProtect

Specifies the new access protection. You can specify any one of the following flags, along with the PAGE_GUARD and PAGE_NOCACHE protection modifier flags, as necessary:

Value Meaning
PAGE_READONLY Enables read access to the committed region of pages. An attempt to write to the committed region results in an access violation. If the system differentiates between read-only access and execute access, an attempt to execute code in the committed region results in an access violation.
PAGE_READWRITE Enables both read and write access to the committed region of pages.
PAGE_WRITECOPY Gives copy-on-write access to the committed region of pages.
PAGE_EXECUTE Enables execute access to the committed region of pages. An attempt to read or write to the committed region results in an access violation.
PAGE_EXECUTE_READ Enables execute and read access to the committed region of pages. An attempt to write to the committed region results in an access violation.
PAGE_EXECUTE_READWRITE Enables execute, read, and write access to the committed region of pages.
PAGE_EXECUTE_WRITECOPY Enables execute, read, and write access to the committed region of pages. The pages are shared read-on-write and copy-on-write.
PAGE_GUARD Pages in the region become guard pages. Any attempt to access a guard page causes the operating system to raise a STATUS_GUARD_PAGE exception and turn off the guard page status. Guard pages thus act as a one-shot access alarm.The PAGE_GUARD flag is a page protection modifier. An application uses it with one of the other page protection flags, with one exception: it cannot be used with PAGE_NOACCESS. When an access attempt leads the operating system to turn off guard page status, the underlying page protection takes over.If a guard page exception occurs during a system service, the service typically returns a failure status indicator.
PAGE_NOACCESS Disables all access to the committed region of pages. An attempt to read from, write to, or execute in the committed region results in an access violation exception, called a general protection (GP) fault.
PAGE_NOCACHE Allows no caching of the committed regions of pages. The hardware attributes for the physical memory should be specified as "no cache." This is not recommended for general usage. It is useful for device drivers; for example, mapping a video frame buffer with no caching. This flag is a page protection modifier, only valid when used with one of the page protections other than PAGE_NOACCESS.


lpflOldProtect

Points to a variable that the function sets to the previous access protection value of the first page in the specified region of pages. If this parameter is NULL or does not point to a valid variable, the function fails.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

You can set the access protection value on committed pages only. If the state of any page in the specified region is not committed, the function fails and returns without modifying the access protection of any pages in the specified region.
The VirtualProtect function changes the access protection of memory in the calling process, and the VirtualProtectEx function changes the access protection of memory in a specified process.
The PAGE_GUARD protection modifier flag establishes guard pages. Guard pages act as one-shot access alarms. See Guard Pages for further discussion of guard pages.

See Also

VirtualAlloc, VirtualProtectEx


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

VirtualProtect



Функция VirtualProtect изменяет защиту доступа в регионе совершенных страниц в виртуальном пространстве адреса вызова процесса. Эта функция отличается от VirtualProtectEx, которое изменяет защиту доступа любого процесса.

BOOL VirtualProtect(

LPVOID lpAddress, // АДРЕС региона совершенных страниц DWORD dwSize, // размера региона DWORD flNewProtect, // желаемой защиты адреса доступа PDWORD lpflOldProtect // переменной, чтобы стареть защитой
);


Параметры

lpAddress

Точки на базовый адрес региона страниц чьи атрибуты защиты доступа должны быть измениться.
Все страницы в определенном регионе по-видимому распределены на единственном вызове в VirtualAlloc или функцию VirtualAllocEx. Страницы не могут распределить (вращать) смежные регионы, которые были распределены отдельными вызовами на VirtualAlloc или VirtualAllocEx.

dwSize

Определяет размер, в байтах, региона чьи атрибуты защиты доступа должны быть измениться. Регион неестественных страниц включает все страницы, содержащие один или более байтов в дипазоне из параметра lpAddress, чтобы (lpAddress+dwSize). Это означает, что 2- байтовый дипазон, перекрывающий страничную границу вызывает атрибуты защиты обеих страниц, которые нужно изменяться.

flNewProtect

Определяет новую защиту доступа. Вы можете определить любое из следующего флагов, вместе с PAGE_GUARD и флагами модификатора защиты PAGE_NOCACHE, как необходимый:

Значение Величины
PAGE_READONLY Приспосабливается прочитанный доступ к совершенному региону страниц. Попытка, чтобы писаться в совершенные результаты региона в нарушении доступа. Если система различается между только для чтения доступом и выполняет доступ, попытка, чтобы выполнять код в совершенных результатах региона в нарушении доступа.
PAGE_READWRITE Приспосабливается как прочитанное так и доступ записи к совершенному региону страниц.
PAGE_WRITECOPY Дает копию-в-писать доступе к совершенному региону страниц.
Приспосабливать PAGE_EXECUTE выполняют доступ к совершенному региону страниц. Попытка, чтобы читать или писаться в совершенные результаты региона в нарушении доступа.
Приспосабливать PAGE_EXECUTE_READ выполняют и читают доступ к совершенному региону страниц. Попытка, чтобы писаться в совершенные результаты региона в нарушении доступа.
Приспосабливать PAGE_EXECUTE_READWRITE выполняют, прочитанное, и доступ записи к совершенному региону страниц.
Приспосабливать PAGE_EXECUTE_WRITECOPY выполняют, прочитанное, и доступ записи к совершенному региону страниц. Страницы распространены прочитанное-в-записи и копии-в-записи.
Страницы PAGE_GUARD в регионе становятся страницами охраны. Любая попытка, чтобы иметь доступ к странице охраны заставляет операционную систему, чтобы поднимать исключение STATUS_GUARD_PAGE и выключать страничный статус охраны. Таким образом действие страниц Охраны как однократная тревога доступа.Флаг PAGE_GUARD является страничным модификатором защиты. Приложение использует это с одним из других страничных флагов защиты, с одним исключением: не может быть использовано PAGE_NOACCESS. Когда попытка доступа ведет операционную систему, чтобы выключать страничный статус охраны, основная страничная защита превышает.Если страничное исключение охраны происходит в течение системной услуги, услуга обычно возвращает указатель статуса неудачи.
PAGE_NOACCESS Выводит из строя весь доступ к совершенному региону страниц. Попытка, чтобы читать из, запись на или выполняется в совершенных результатах региона в исключение нарушение доступ, назвавших общую защиту (GP) дефект.
PAGE_NOCACHE не Допускает никакое кэширование совершенных регионов страниц. Аппаратные атрибуты для физической памяти должны быть определены как "никакой кеш." Это не рекомендован для общего использования. Это полезное для водителей устройства; например, отображая видео фреймовый буфер без кэширования. Этот флаг - страничный модификатор защиты, только правильный когда использовано одной из страничных защит кроме PAGE_NOACCESS.


lpflOldProtect

Точки на переменную, что функция устанавливается в величину защиты предшествующего доступа первой страницы в определенной области страниц. Если этот параметр НЕДЕЙСТВИТЕЛЕН или не указывает на правильную переменную, функция терпит неудачу.



Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Вы можете установить величину защиты доступа на совершенных страницах только. Если состояние любой страницы в определенной области не совершено, функция терпит неудачу и не возвращает модифицируя защиту доступа любых страниц в определенной области.
Функция VirtualProtect изменяет защите доступа памяти на вызове процесса, и функциональных изменениях VirtualProtectEx защита доступа памяти в определенном процессе.
Флаг модификатора защиты PAGE_GUARD устанавливает страницы охраны. Действие страниц Охраны как однократные тревоги доступа. Смотри Страницы Охраны для дальнейшей дискуссии страниц охраны.

Смотри Также

VirtualAlloc, VirtualProtectEx


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz