Функция OpenJobObjectA (winbase.h)

  • Статья

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

Синтаксис

HANDLE OpenJobObjectA(
  [in] DWORD  dwDesiredAccess,
  [in] BOOL   bInheritHandle,
  [in] LPCSTR lpName
);

Параметры

[in] dwDesiredAccess

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

[in] bInheritHandle

Если это значение равно TRUE, процессы, созданные этим процессом, наследуют дескриптор. В противном случае процессы не наследуют этот дескриптор.

[in] lpName

Имя открываемого задания. Сравнение имен учитывает регистр.

Эта функция может открывать объекты в частном пространстве имен. Дополнительные сведения см. в разделе Пространства имен объектов.

Службы терминалов: Имя может иметь префикс "Global" или "Local" для явного открытия объекта в глобальном пространстве имен или пространстве имен сеанса. Оставшаяся часть имени может содержать любой символ, кроме символа обратной косой черты (\). Дополнительные сведения см. в разделе Пространства имен объектов ядра.

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

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

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

Ошибка ERROR_FILE_NOT_FOUND указывает, что задание, указанное в lpName , не существует.

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winbase.h (включая Windows.h, Jobapi2.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

AssignProcessToJobObject

Объекты заданий

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