Функция OpenThread


Функция OpenThread открывает объект существующего потока.

Синтаксис

HANDLE OpenThread(

DWORD dwDesiredAccess, // право доступа
BOOL
bInheritHandle,   // опции наследования дескриптора
DWORD
dwThreadId       // идентификатор потока

);

Параметры

dwDesiredAccess

[in] Доступ к объекту потока. Этот параметр может состоять из одного или нескольких прав доступа потока.

Windows NT/2000/XP: Это право доступа проверяется у любого дескриптора безопасности потока.

bInheritHandle

[in] Если этот параметр является ИСТИНА (TRUE), новый процесс наследует дескриптор. Если этот параметр - ЛОЖЬ (FALSE), дескриптор не наследуется.

dwThreadId

[in] Идентификатор открытого потока.

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

Если функция завершается успешно, величина возвращаемого значения - открытый дескриптор заданного процесса.

Если функция завершается с ошибкой, величина возвращаемого значения равна ПУСТО (NULL). Чтобы получить дополнительные данные об ошибках, вызовите GetLastError.

Замечания

Дескриптор, возвращенный функцией OpenThread, может быть использован в любой функции, которая требует дескриптора к потоку, типа функций ожидания, предоставляя требуемые соответствующие права доступа. Дескриптор предоставляет доступ к объекту потока только в пределах, которые были заданы в параметре dwDesiredAccess .

Когда Вы завершаете работу с дескриптором, убедитесь, что закрыли его при помощи использования функция CloseHandle.

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, CloseHandle, GetExitCodeThread, GetThreadContext, ResumeThread, SetThreadContext, SetTokenInformation, SuspendThread, TerminateThread

Размещение и совместимость OpenThread

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Нет

Windows Me

Да

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz