SetUmsThreadInformation 函式 (winbase.h)

  • 發行項

設定指定之使用者模式排程的應用程式特定內容資訊， (UMS) 背景工作執行緒。

警告

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

語法

BOOL SetUmsThreadInformation(
  [in] PUMS_CONTEXT          UmsThread,
  [in] UMS_THREAD_INFO_CLASS UmsThreadInfoClass,
  [in] PVOID                 UmsThreadInformation,
  [in] ULONG                 UmsThreadInformationLength
);

參數

[in] UmsThread

UMS 執行緒內容的指標。

[in] UmsThreadInfoClass

UMS_THREAD_INFO_CLASS值，指定要設定的資訊種類。 此參數必須是 UmsThreadUserCoNtext。

[in] UmsThreadInformation

緩衝區的指標，其中包含要設定的資訊。

[in] UmsThreadInformationLength

UmsThreadInformation緩衝區的大小，以位元組為單位。

傳回值

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

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 可能的錯誤值包括下列專案。

傳回碼 描述
ERROR_INFO_LENGTH_MISMATCH
 緩衝區大小不符合指定資訊類別的必要大小。
ERROR_INVALID_INFO_CLASS
 UmsThreadInfoClass參數指定不支援的資訊類別。
ERROR_NOT_SUPPORTED
 不支援 UMS。

備註

SetUmsThreadInformation函式可用來設定指定 UMS 背景工作執行緒的應用程式定義內容。 內容資訊可以包含應用程式可能尋找的實用專案來追蹤，例如每個排程器或每一背景工作角色執行緒狀態。 UMS 背景工作執行緒的基礎結構是由系統管理，不應直接修改。

QueryUmsThreadInformation函式可用來擷取指定執行緒的其他公開資訊，例如其執行緒執行區塊 (TEB) ，以及執行緒是否已暫停或終止。 未透過 QueryUmsThreadInformation 公開的資訊應該視為保留。

規格需求

   
最低支援的用戶端 僅限 Windows 7 (64 位) [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平臺 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll
API 集合 api-ms-win-core-ums-l1-1-0 (在 Windows 7)

另請參閱

QueryUmsThreadInformation