Функция QueryInformationJobObject
Функция
QueryInformationJobObject извлекает ограничение и информацию о состоянии задания из объекта задания.Синтаксис
BOOLQueryInformationJobObject( 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 |
Нет |
Замечания по платформе |
Не имеется |