OpenProcess

既存のローカルプロセスオブジェクトを開く。

OpenProcess dwDesiredAccess, bInheritHandle, dwProcessId

dwDesiredAccess : [int] プロセスオブジェクトへのアクセス。プロセスのセキュリティ記述子と照合される。1 つ以上のプロセスアクセス権を指定できる。SeDebugPrivilege 特権が有効な場合、セキュリティ記述子の内容に関わらず要求アクセスが付与される。
bInheritHandle : [int] TRUE の場合、このプロセスが作成するプロセスがハンドルを継承する。それ以外は継承しない。
dwProcessId : [int] 開くローカルプロセスの識別子。System Idle Process(0x00000000)を指定した場合、関数は失敗し、last error は ERROR_INVALID_PARAMETER。System プロセスや CSRSS プロセスの場合は ERROR_ACCESS_DENIED で失敗する。GetCurrentProcessId を引数に使う場合は、代わりに GetCurrentProcess を使うとよい。

(プラグイン / モジュール : kernel32.dll)

解説

既存のローカルプロセスオブジェクトを開く。

[戻り値]
関数が成功した場合、戻り値は指定されたプロセスへのオープンハンドル。失敗した場合は NULL。拡張エラー情報は GetLastError
で取得する。

[備考]
他のローカルプロセスへのフルアクセスハンドルを開くには SeDebugPrivilege
特権を有効にする必要がある。OpenProcess が返すハンドルは、適切なアクセス権が要求されていれば wait
関数などプロセスハンドルを必要とする任意の関数で使用できる。ハンドルの使用が終わったら CloseHandle で閉じること。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs