Функция SetInformationJobObject


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

Синтаксис

BOOL SetInformationJobObject( 

HANDLE hJob,                // дескриптор задания 
JOBOBJECTINFOCLASS
JobObjectInfoClass, // класс информации 
LPVOID
lpJobObjectInfo,     // информация об ограничении 
DWORD
cbJobObjectInfoLength // размер информации об ограничении 

);

Параметры

hJob

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

JobObjectInfoClass

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

Значение

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

JobObjectAssociateCompletionPortInformation

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

JobObjectBasicLimitInformation

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

JobObjectBasicUIRestrictions

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

JobObjectEndOfJobTimeInformation

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

JobObjectExtendedLimitInformation

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

JobObjectSecurityLimitInformation

Параметр lpJobObjectInfo является указателем на структуру JOBOBJECT_SECURITY_LIMIT_INFORMATION. Дескриптор hJob должен иметь право доступа JOB_OBJECT_SET_SECURITY_ATTRIBUTES, чтобы связаться с ним.

lpJobObjectInfo

[in] Ограничения, которые будут установлены для задания. Формат этих данных зависит от значение параметра JobObjectInfoClass

cbJobObjectInfoLength

[in] Размер устанавливаемой информации для задания, в байтах.

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

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

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

Замечания

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

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

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, JOBOBJECT_ASSOCIATE_COMPLETION_PORT, JOBOBJECT_BASIC_LIMIT_INFORMATION, JOBOBJECT_BASIC_UI_RESTRICTIONS, JOBOBJECT_END_OF_JOB_TIME_INFORMATION, JOBOBJECT_EXTENDED_LIMIT_INFORMATION, JOBOBJECT_SECURITY_LIMIT_INFORMATION, QueryInformationJobObject

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

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