InitializeProcessForWsWatch 関数 (psapi.h)

指定したプロセスのワーキング セットの監視を開始します。 GetWsChanges 関数を呼び出す前に、この関数を呼び出す必要があります。

構文

BOOL InitializeProcessForWsWatch(
  [in] HANDLE hProcess
);

パラメーター

[in] hProcess

プロセスへのハンドル。 ハンドルには、PROCESS_QUERY_INFORMATIONアクセス権が必要です。 詳細については、「 プロセス のセキュリティとアクセス権」を参照してください。

戻り値

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

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

解説

Windows 7 および Windows Server 2008 R2 以降、Psapi.h は PSAPI 関数のバージョン番号を確立します。 PSAPI バージョン番号は、プログラムが読み込む必要がある関数とライブラリの呼び出しに使用される名前に影響します。

PSAPI_VERSIONが 2 以上の場合、この関数は Psapi.h の K32InitializeProcessForWsWatch として定義され、Kernel32.lib および Kernel32.dll でエクスポートされます。 PSAPI_VERSION が 1 の場合、この関数は Psapi.h の InitializeProcessForWsWatch として定義され、Psapi.lib でエクスポートされ、K32InitializeProcessForWsWatch を呼び出すラッパーとして Psapi.dll されます。

以前のバージョンの Windows および Windows 7 以降のバージョンで実行する必要があるプログラムは、常に InitializeProcessForWsWatch としてこの関数を呼び出す必要があります。 シンボルを正しく解決するには、 PSapi.lib を TARGETLIBS マクロに追加し、 -DPSAPI_VERSION=1 でプログラムをコンパイルします。 実行時の動的リンクを使用するには、Psapi.dll を読み込みます。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	psapi.h
Library	Windows 7 および Windows Server 2008 R2 の Kernel32.lib。Windows 7 および Windows Server 2008 R2 の Psapi.lib (PSAPI_VERSION=1 の場合)。Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP の Psapi.lib
[DLL]	Windows 7 および Windows Server 2008 R2 で Kernel32.dll。Windows 7 および Windows Server 2008 R2 で Psapi.dll (PSAPI_VERSION=1 の場合)。Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP の Psapi.dll

関連項目

EnumProcesses

GetWsChanges

PSAPI 関数

ワーキング セット情報