Поделиться через


Функция NtOpenThread

[Эта функция может быть изменена или удалена из Windows без дополнительного уведомления. Вместо этого используйте функцию OpenThread .]

Открывает дескриптор для объекта потока с указанным доступом.

Синтаксис

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

Параметры

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, элемент ObjectName структуры, на который указывает параметр ObjectAttributes , должен иметь значение NULL.

Возвращаемое значение

Возвращает ntstatus или код ошибки.

Формы и важность кодов ошибок NTSTATUS перечислены в файле заголовка Ntstatus.h, доступном в WDK, и описаны в документации по WDK.

Комментарии

У этой функции нет связанного файла заголовка. Связанная библиотека импорта Ntdll.lib доступна в WDK. Вы также можете использовать функции LoadLibrary и GetProcAddress для динамической связи с Ntdll.dll.

Требования

Требование Значение
DLL
Ntdll.dll