Функция OpenJobObject

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

Синтаксис
HANDLE OpenJobObject(
  DWORD dwDesiredAccess,  // право доступа
  BOOL bInheritHandles,   // состояние наследования
  LPCTSTR lpName          // имя задания
);

Параметры

dwDesiredAccess

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

bInheritHandles

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

lpName

[in] Указатель на символьную строку с нулем в конце, устанавливающую имя задания, которое будет открыто. Имя сравнивается с учетом регистра.

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

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

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

Замечания

Чтобы связать процесс с заданием, используйте функцию AssignProcessToJobObject.

Чтобы компилировать приложение, которое использует эту функцию, определите макрокоманду _WIN32_WINNT как 0x0500 или позже. Для получения дополнительной информации, см. статью Использование заголовков SDK

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, AssignProcessToJobObject

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Нет

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

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

Kernel32.lib

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

  

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Реализуется как версии Unicode и ANSI.

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

Не имеется

 

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

Hosted by uCoz