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 ()

另请参阅

CreateUmsThreadContext

QueryUmsThreadInformation