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。


最低受支持的客户端	仅 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 ()