OpenThread 函数 (processthreadapi.h)

打开现有线程对象。

语法

HANDLE OpenThread(
  [in] DWORD dwDesiredAccess,
  [in] BOOL  bInheritHandle,
  [in] DWORD dwThreadId
);

参数

[in] dwDesiredAccess

对线程对象的访问。 针对线程的安全描述符检查此访问权限。 此参数可以是一个或多个 线程访问权限

如果调用方已启用 SeDebugPrivilege 特权,则会授予请求的访问权限,而不考虑安全描述符的内容。

[in] bInheritHandle

如果此值为 TRUE,则此进程创建的进程将继承句柄。 否则,进程不会继承此句柄。

[in] dwThreadId

要打开的线程的标识符。

返回值

如果函数成功,则返回值是指定线程的打开句柄。

如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。

注解

OpenThread 返回的句柄可用于需要线程句柄的任何函数(例如等待函数),前提是你请求了适当的访问权限。 仅在 dwDesiredAccess 参数中指定的范围内,才向句柄授予对线程对象的访问权限。

完成句柄后,请务必使用 CloseHandle 函数将其关闭。

要求

要求
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 processthreadsapi.h (包括 Windows Server 2003 上的 Windows.h、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

CloseHandle

GetExitCodeThread

GetThreadContext

进程和线程函数

ResumeThread

SetThreadContext

SetTokenInformation

SuspendThread

TerminateThread

线程