createUmsThreadContext 函数 (winbase.h)
创建用户模式计划 (UMS) 线程上下文来表示 UMS 工作线程。
警告
自Windows 11起,不支持用户模式计划。 所有调用都失败,并出现错误 ERROR_NOT_SUPPORTED
。
语法
BOOL CreateUmsThreadContext(
[out] PUMS_CONTEXT *lpUmsThread
);
参数
[out] lpUmsThread
PUMS_CONTEXT变量。 输出时,此参数接收指向 UMS 线程上下文的指针。
返回值
如果函数成功,则返回非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。 可能的错误值包括以下内容。
返回代码 | 说明 |
---|---|
|
内存不足,无法创建 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 () |