WTSActiveSessionExists 函式 （wtsapi32.h）

如果系統上有作用中會話，而不需要列舉會話清單，則會傳回。 它也不會從「本端階段作業管理程式」取得任何額外資訊。

語法

BOOL WTSActiveSessionExists(
  [out] PBOOL pbActiveSessionExists
);

參數

[out] pbActiveSessionExists

布林值的指標，指出作用中工作階段是否存在。

返回值

如果此函式失敗，則傳回零。 如果此函式成功，則會傳回非零值。

備註

此函式只會判斷作用中工作階段是否存在。 若要取得工作階段及其狀態的清單，請使用 WTSEnumerateSessions。 許多在會話 0 中執行的進程使用 WTSEnumerateSessions 來檢查活動會話是否存在，或在活動會話存在時執行操作（即：取得使用者名稱、會話 ID 等）。 當沒有作用中會話時，使用 WTSEnumerateSessions 會很昂貴，因為必須列舉整個非作用中會話清單。

需求