NtOpenThread 函数

[此函数可能会更改或从 Windows 中删除,而无需进一步通知。 请改用 OpenThread 函数。]

打开具有指定访问权限的线程对象的句柄。

语法

NTSTATUS NtOpenThread(
  _Out_ PHANDLE            ThreadHandle,
  _In_  ACCESS_MASK        DesiredAccess,
  _In_  POBJECT_ATTRIBUTES ObjectAttributes,
  _In_  PCLIENT_ID         ClientId
);

parameters

ThreadHandle [out]

指向接收线程对象句柄的变量的指针。

DesiredAccess [in]

为线程对象提供所需访问类型的 ACCESS_MASK 数据类型。

ObjectAttributes [in]

指向 OBJECT_ATTRIBUTES 结构的指针。 此结构的 ObjectName 成员必须为 NULL。

Windows Server 2003 和 Windows XP: 此结构的 ObjectName 成员可以指向对象名称。 如果 ObjectName 不为 NULL,则 ClientId 参数必须为 NULL。

ClientId [in]

指向 CLIENT_ID 结构的指针,该结构标识要打开其线程的线程。

Windows Server 2003 和 Windows XP: 指向 CLIENT_ID 结构的指针,该结构标识要打开其线程的线程。 此参数可以为 NULL。 如果此参数不为 NULL,则 ObjectAttributes 参数指向的结构的 ObjectName 成员必须为 NULL。

返回值

返回 NTSTATUS 或错误代码。

NTSTATUS 错误代码的形式和意义列在 WDK 中提供的 Ntstatus.h 头文件中,并在 WDK 文档中介绍。

备注

此函数没有关联的头文件。 关联的导入库 Ntdll.lib 在 WDK 中可用。 还可以使用 LoadLibraryGetProcAddress 函数动态链接到Ntdll.dll。

要求

要求
DLL
Ntdll.dll