指定プロセスのワーキングセットに現在追加されているページに関する情報を取得する。
QueryWorkingSet hProcess, pv, cb
hProcess : [intptr] プロセスのハンドル。ハンドルには PROCESS_QUERY_INFORMATION および PROCESS_VM_READ アクセス権が必要である。詳細は「Process Security and Access Rights」を参照。 pv : [intptr] 情報を受け取るバッファへのポインタ。詳細は PSAPI_WORKING_SET_INFORMATION を参照。pv パラメータが指すバッファが対象プロセスのすべてのワーキングセットエントリを格納するのに十分でない場合、関数は ERROR_BAD_LENGTH で失敗する。この場合、PSAPI_WORKING_SET_INFORMATION 構造体の NumberOfEntries メンバーには必要なエントリ数が設定されるが、関数はワーキングセットエントリの情報を返さない。 cb : [int] pv バッファのサイズ(バイト単位)。
(プラグイン / モジュール : psapi.dll)
指定プロセスのワーキングセットに現在追加されているページに関する情報を取得する。 [戻り値] 関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには GetLastError を呼び出す。 [備考] Windows 7 および Windows Server 2008 R2 以降、Psapi.h は PSAPI 関数群にバージョン番号を設定している。PSAPI バージョン番号は、関数を呼び出す際に使用する名前と、プログラムがロードする必要のあるライブラリに影響を与える。PSAPI_VERSION が 2 以上の場合、この関数は Psapi.h で K32QueryWorkingSet として定義され、Kernel32.lib および Kernel32.dll からエクスポートされる。PSAPI_VERSION が 1 の場合、この関数は Psapi.h で QueryWorkingSet として定義され、K32QueryWorkingSet を呼び出すラッパーとして Psapi.lib および Psapi.dll からエクスポートされる。Windows の旧バージョンと Windows 7 以降の両方で動作する必要があるプログラムは、常に QueryWorkingSet として呼び出すべきである。シンボル解決を正しく行うには、TARGETLIBS マクロに Psapi.lib を追加し、-DPSAPI_VERSION=1 を指定してプログラムをコンパイルする。実行時動的リンクを利用するには、Psapi.dll をロードする。
| プラグイン / モジュール | psapi.dll |
| バージョン | 1.0 |
| 作成日 | 2026/04/16 |
| 著作者 | IronHSP / CsWin32 bridge |
| URL | https://github.com/inovia/IronHSP |
| 備考 | Win32 API の psapi.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。 |
| タイプ | 拡張命令 |
| グループ | Win32API |
| 対応環境 |
|
| hs ファイル | hsphelp\win32_psapi_gen2.hs |