Функция OpenProcess


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

Синтаксис

HANDLE OpenProcess(

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

);

Параметры

dwDesiredAccess

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

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

bInheritHandle

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

dwProcessId

[in] Идентификатор процесса, который открыт.

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

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

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

Замечания

Дескриптор, возвращенный функцией OpenProcess, может быть использован в любой функции, которая требует дескриптора процесса, в такой, как функции ожидания (wait functions), предоставляя соответствующие права доступа, которые были затребованы.

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

Код примера

Пример смотри в статье Захват снимка мгновенного состояния и просмотр процессов.

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, AssignProcessToJobObject, CloseHandle, CreateProcess, CreateRemoteThread, DuplicateHandle, GetCurrentProcess, GetCurrentProcessId, GetExitCodeProcess, GetModuleFileNameEx, GetPriorityClass, ReadProcessMemory, SetPriorityClass, SetProcessWorkingSetSize, TerminateProcess, VirtualProtectEx, WriteProcessMemory

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

Kernel32.lib

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

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет 

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

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки
Перевод 06.08.2003 13:07 ©Copyright V. Sokovikov
Hosted by uCoz