DeleteUmsThreadContext 函式 (winbase.h)

刪除指定的使用者模式排程 (UMS) 執行緒內容。執行緒必須終止。

警告

自Windows 11起，不支援使用者模式排程。所有呼叫都會失敗，並出現錯誤 ERROR_NOT_SUPPORTED 。

語法

BOOL DeleteUmsThreadContext(
  [in] PUMS_CONTEXT UmsThread
);

[in] UmsThread

要刪除之 UMS 執行緒內容的指標。 CreateUmsThreadCoNtext函式會提供此指標。

如果函式成功，它會傳回非零值。

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

在相關聯的執行緒終止之前，無法刪除 UMS 執行緒內容。

例如，當 UMS 背景工作執行緒完成執行 (時，藉由從執行緒進入點函式傳回) 、系統終止執行緒、線上程的 UMS 執行緒內容中設定終止狀態，並將 UMS 執行緒內容排入相關聯的完成清單。

任何執行 UMS 執行緒的嘗試都會失敗，因為執行緒已經終止。

若要檢查執行緒的終止狀態，應用程式的排程器應該使用UmsIsThreadTerminated資訊類別呼叫QueryUmsThreadInformation。