VirtualProtectEx 関数 (memoryapi.h)

指定したプロセスの仮想アドレス空間内のコミット済みページの領域の保護を変更します。

構文

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

パラメーター

[in] hProcess

メモリ保護を変更するプロセスのハンドル。 ハンドルには、 PROCESS_VM_OPERATION アクセス権が必要です。 詳細については、「 セキュリティとアクセス権の処理」を参照してください。

[in] lpAddress

アクセス保護属性を変更するページの領域のベース アドレスへのポインター。

指定したリージョン内のすべてのページは、MEM_RESERVEを使用して VirtualAlloc または VirtualAllocEx 関数を呼び出すときに割り当てられた同じ予約リージョン内に存在する必要があります。 ページは、MEM_RESERVEを使用して VirtualAlloc または VirtualAllocEx への個別の呼び出しによって割り当てられた隣接する予約リージョンにまたがることはできません。

[in] dwSize

アクセス保護属性が変更されたリージョンのサイズ (バイト単位)。 影響を受けるページの領域には、 lpAddress パラメーターから までの範囲内の 1 つ以上のバイトを含むすべてのページが (lpAddress+dwSize)含まれます。 つまり、ページ境界にまたがる 2 バイト範囲では、両方のページの保護属性が変更されます。

[in] flNewProtect

メモリ保護オプション。 このパラメーターには、 メモリ保護定数のいずれかを指定できます。

マップされたビューの場合、この値は、ビューがマップされたときに指定されたアクセス保護と互換性がある必要があります ( 「MapViewOfFile、 MapViewOfFileEx、および MapViewOfFileExNuma」を参照してください)。

[out] lpflOldProtect

指定したページ領域の最初のページの以前のアクセス保護を受け取る変数へのポインター。 このパラメーターが NULL であるか、有効な変数を指していない場合、関数は失敗します。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

アクセス保護の値は、コミットされたページでのみ設定できます。 指定したリージョン内のページの状態がコミットされていない場合、関数は失敗し、指定したリージョン内のページのアクセス保護を変更せずに を返します。

PAGE_GUARD保護修飾子は、保護ページを確立します。 ガード ページは、ワンショット アクセス アラームとして機能します。 詳細については、「Creating Guard Pages」 (ガード ページの作成) をご覧ください。

1 つのページに複数のメモリ ブロックが存在する可能性があるため、 VirtualProtectEx を使用して GlobalAlloc、 HeapAlloc、または LocalAlloc によって割り当てられたメモリ ブロックのページ保護を変更しないようにすることをお勧めします。 ヒープ マネージャーは、ヒープ内のすべてのページが少なくとも読み取りおよび書き込みアクセス権を付与することを前提としています。

実行可能なリージョンを保護する場合、呼び出し元のプログラムは、コードが設定されたら 、FlushInstructionCache への適切な呼び出しを介してキャッシュの一貫性を確保する責任を負います。 そうしないと、新しく実行可能なリージョンからコードを実行しようとすると、予期しない結果が発生する可能性があります。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	memoryapi.h (Windows.h、Memoryapi.h を含む)
Library	onecore.lib
[DLL]	Kernel32.dll

関連項目

メモリ管理関数

メモリ保護定数

仮想メモリ関数

VirtualAlloc

VirtualProtect

VirtualQueryEx