Функция QueryInformationJobObject


Функция QueryInformationJobObject извлекает ограничение и информацию о состоянии задания из объекта задания.

Синтаксис
BOOL QueryInformationJobObject(
  HANDLE hJob,                           // дескриптор задания
  JOBOBJECTINFOCLASS JobObjectInfoClass, // класс информации
  LPVOID lpJobObjectInfo,                // информация об ограничении
  DWORD cbJobObjectInfoLength,           // размер информации об ограничении
  LPDWORD lpReturnLength                 // запись данных
);

Параметры

hJob

[in] Дескриптор задания, информация о котором запрашивается. Функция CreateJobObject или OpenJobObject возвращает этот дескриптор. Дескриптор должен иметь право доступа JOB_OBJECT_QUERY. Для получения дополнительной информации, см. Защита объекта задания и права доступа.

Если это значение ПУСТО (NULL), а вызывающий процесс связан с заданием, используется задание, связанное с вызывающим процессом.

JobObjectInfoClass

[in] Класс информации об ограничениях, на которые был сделан запрос. Этот параметр может быть одним из нижеследующих значений.

 

Значение

Предназначение

JobObjectBasicAccountingInformation

Параметр lpJobObjectInfo является указателем на структуру JOBOBJECT_BASIC_ACCOUNTING_INFORMATION. 

JobObjectBasicAndIoAccountingInformation

Параметр lpJobObjectInfo является указателем на структуру JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION. 

JobObjectBasicLimitInformation

Параметр lpJobObjectInfo является указателем на структуру JOBOBJECT_BASIC_LIMIT_INFORMATION. 

JobObjectBasicProcessIdList

Параметр lpJobObjectInfo является указателем на структуру JOBOBJECT_BASIC_PROCESS_ID_LIST. 

JobObjectBasicUIRestrictions

Параметр lpJobObjectInfo является указателем на структуру JOBOBJECT_BASIC_UI_RESTRICTIONS. 

JobObjectExtendedLimitInformation

Параметр lpJobObjectInfo является указателем на структуру JOBOBJECT_EXTENDED_LIMIT_INFORMATION. 

JobObjectSecurityLimitInformation

Параметр lpJobObjectInfo является указателем на структуру JOBOBJECT_SECURITY_LIMIT_INFORMATION.

lpJobObjectInfo

[out] Информация об ограничении. Формат этих данных зависит от значение параметра JobObjectInfoClass.

cbJobObjectInfoLength

[in] Итоговое число запрошенной информации о задании, в байтах.

lpReturnLength

[out] Указатель на переменную, которая получает длину данных, записанных в структуре, указанной параметром lpJobObjectInfo. Если Вы не желаете получать эту информацию, установите значение ПУСТО (NULL).

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

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

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

Замечания

Вы можете использовать функцию QueryInformationJobObject, чтобы получить текущие ограничения, изменять их, а затем использовать функцию SetInformationJobObject, чтобы установить новые ограничения.

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

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, JOBOBJECT_BASIC_ACCOUNTING_INFORMATION, JOBOBJECT_BASIC_AND_IO_ACCOUNTING_INFORMATION, JOBOBJECT_BASIC_LIMIT_INFORMATION, JOBOBJECT_BASIC_PROCESS_ID_LIST, JOBOBJECT_BASIC_UI_RESTRICTIONS, JOBOBJECT_EXTENDED_LIMIT_INFORMATION, JOBOBJECT_SECURITY_LIMIT_INFORMATION, SetInformationJobObject

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

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