Функция OpenThread (processthreadsapi.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 .

Требования

См. также

CloseHandle

GetExitCodeThread

GetThreadContext

Функции процессов и потоков

ResumeThread

SetThreadContext

SetTokenInformation

SuspendThread

TerminateThread

Потоки