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 |