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 [僅限傳統型應用程式]
標頭 processthreadsapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)

另請參閱

CreateProcess

CreateProcessAsUser

CreateProcessWithLogonW

CreateProcessWithTokenW