Функция OpenThread (processthreadsapi.h)

Статья
08/25/2023

Открывает существующий объект потока.

Синтаксис

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
Header	processthreadsapi.h (включая Windows.h в Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека	Kernel32.lib
DLL	Kernel32.dll