createUmsThreadContext 函数 (winbase.h)

创建用户模式计划 (UMS) 线程上下文来表示 UMS 工作线程。

警告

自Windows 11起，不支持用户模式计划。所有调用都失败，并出现错误 ERROR_NOT_SUPPORTED。

语法

BOOL CreateUmsThreadContext(
  [out] PUMS_CONTEXT *lpUmsThread
);

[out] lpUmsThread

PUMS_CONTEXT变量。输出时，此参数接收指向 UMS 线程上下文的指针。

如果函数成功，则返回非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。可能的错误值包括以下内容。

返回代码	说明
ERROR_NOT_ENOUGH_MEMORY	内存不足，无法创建 UMS 线程上下文。

UMS 线程上下文表示 UMS 工作线程的状态。线程上下文用于在函数调用中指定 UMS 工作线程。

通过使用 InitializeProcThreadAttributeList 和 UpdateProcThreadAttributeList 准备线程的 UMS 属性列表后，通过调用 CreateRemoteThreadEx 函数来创建 UMS 工作线程。

UMS 线程上下文的基础结构由系统管理，不应直接修改。若要获取和设置有关 UMS 工作线程的信息，请使用 QueryUmsThreadInformation 和 SetUmsThreadInformation 函数。

UMS 工作线程终止后，应通过调用 DeleteUmsThreadContext 释放其线程上下文。

要求	值
最低受支持的客户端	仅 Windows 7 (64 位) [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	winbase.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll
API 集	windows 7 中引入的 api-ms-win-core-ums-l1-1-0 ()