PROCESS_INFORMATION 構造体 (processthreadsapi.h)
新しく作成されたプロセスとそのプライマリ スレッドに関する情報が含まれます。 これは、 CreateProcess、 CreateProcessAsUser、 CreateProcessWithLogonW、または CreateProcessWithTokenW 関数と共に使用されます。
構文
typedef struct _PROCESS_INFORMATION {
HANDLE hProcess;
HANDLE hThread;
DWORD dwProcessId;
DWORD dwThreadId;
} PROCESS_INFORMATION, *PPROCESS_INFORMATION, *LPPROCESS_INFORMATION;
メンバー
hProcess
新しく作成されたプロセスへのハンドル。 ハンドルは、プロセス オブジェクトに対して操作を実行するすべての関数でプロセスを指定するために使用されます。
hThread
新しく作成されたプロセスのプライマリ スレッドへのハンドル。 ハンドルは、スレッド オブジェクトに対して操作を実行するすべての関数でスレッドを指定するために使用されます。
dwProcessId
プロセスを識別するために使用できる値。 この値は、プロセスが作成されてから、プロセスへのすべてのハンドルが閉じられ、プロセス オブジェクトが解放されるまで有効です。この時点で、識別子を再利用できます。
dwThreadId
スレッドを識別するために使用できる値。 値は、スレッドが作成された時点から、スレッドへのすべてのハンドルが閉じられ、スレッド オブジェクトが解放されるまで有効です。この時点で、識別子を再利用できます。
注釈
関数が成功した場合は、 CloseHandle 関数を呼び出して 、hProcess ハンドルと hThread ハンドルが終了したら、それらを閉じてください。 それ以外の場合、子プロセスが終了しても、親プロセスには子プロセスに対する開いているハンドルが残っているため、システムは子プロセスのプロセス構造をクリーンできません。 ただし、親プロセスが終了するとシステムはこれらのハンドルを閉じるので、子プロセス オブジェクトに関連する構造体はこの時点でクリーンアップされます。
例
例については、「 プロセスの作成」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
Header | processthreadsapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2 の Windows.h を含む) |