Функция QueryIoRateControlInformationJobObject (jobapi2.h)

Возвращает сведения об управлении скоростью ввода-вывода для объекта задания.

Синтаксис

DWORD QueryIoRateControlInformationJobObject(
  [in, optional] HANDLE                                hJob,
  [in, optional] PCWSTR                                VolumeName,
  [out]          JOBOBJECT_IO_RATE_CONTROL_INFORMATION **InfoBlocks,
  [out]          ULONG                                 *InfoBlockCount
);

Параметры

[in, optional] hJob

Дескриптор задания для запроса сведений. Получите этот дескриптор из функции CreateJobObject или OpenJobObject . Дескриптор должен иметь право доступа к JOB_OBJECT_QUERY . Дополнительные сведения о правах доступа см. в разделе Безопасность объектов задания и права доступа.

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

[in, optional] VolumeName

Имя тома для запроса. Если это значение равно NULL, функция получает сведения об управлении скоростью ввода-вывода для задания для всех томов системы.

[out] InfoBlocks

Указатель на массив JOBOBJECT_IO_RATE_CONTROL_INFORMATION структур, содержащих сведения об управлении скоростью ввода-вывода для задания. Код должен освободить память для этого массива, вызвав функцию FreeMemoryJobObject с адресом массива.

[out] InfoBlockCount

Количество JOBOBJECT_IO_RATE_CONTROL_INFORMATION структур, выделенных функцией в массиве, на который указывает параметр InfoBlocks .

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

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

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

Комментарии

Требования

См. также

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject