共用方式為

WTSEnumerateProcessesExW 函式 （wtsapi32.h）

  • 發行項

擷取指定遠端桌面會話主機 （RD 工作階段主機） 伺服器或遠端桌面虛擬化主機 （RD 虛擬化主機） 伺服器上作用中進程的相關信息。

語法

BOOL WTSEnumerateProcessesExW(
  [in]      HANDLE hServer,
  [in, out] DWORD  *pLevel,
  [in]      DWORD  SessionId,
  [out]     LPWSTR *ppProcessInfo,
  [out]     DWORD  *pCount
);

參數

[in] hServer

RD 工作階段主機伺服器的句柄。 指定由 WTSOpenServer 函式開啟的句柄，或指定 WTS_CURRENT_SERVER_HANDLE 來指出應用程式執行所在的伺服器。

[in, out] pLevel

DWORD 變數的指標，在輸入上指定要傳回的信息類型。 若要傳回 WTS_PROCESS_INFO 結構的數位，請指定零。 若要傳回 WTS_PROCESS_INFO_EX 結構的數位，請指定一個。

如果您未指定此參數的有效值，請在輸出上 WTSEnumerateProcessesEx 將此參數設定為一個，並傳回錯誤。 否則，在輸出上，WTSEnumerateProcessesEx 不會變更此參數的值。

[in] SessionId

要列舉進程的會話。 若要列舉伺服器上所有工作階段的行程，請指定 WTS_ANY_SESSION。

[out] ppProcessInfo

變數的指標，接收 WTS_PROCESS_INFO 或 WTS_PROCESS_INFO_EX 結構的陣列指標。 結構的類型取決於傳遞至 pLevel 參數的值。 數位中的每個結構都包含使用中進程的相關信息。 當您完成使用陣列時，請呼叫 WTSFreeMemoryEx 函式來釋放陣列。 您也應該將指標設定為 NULL。

[out] pCount

接收數目之變數的指標
在 ppProcessInfo 參數所參考的緩衝區中傳回的結構。

傳回值

如果函式成功，則傳回值是非零值。

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 getLastError 函式 。

言論

呼叫端必須是 Administrators 群組的成員，才能列舉在另一個使用者會話下執行的進程。

注意

wtsapi32.h 標頭會根據 UNICODE 預處理器常數的定義，將 WTSEnumerateProcessesEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 7
支援的最低伺服器 Windows Server 2008 R2
目標平臺 窗戶
標頭 wtsapi32.h
連結庫 Wtsapi32.lib
DLL Wtsapi32.dll
API 集 ext-ms-win-session-wtsapi32-l1-1-0 （在 Windows 8 中引進）

另請參閱

WTSOpenServer

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX