Функция ReportJobProcessingProgress
Сообщает службе очереди печати печати, находится ли задание печати XPS на этапе очереди или отрисовки, а также о том, какая часть обработки выполняется в настоящее время.
Синтаксис
HRESULT ReportJobProcessingProgress(
_In_ HANDLE printerHandle,
_In_ ULONG jobId,
EPrintXPSJobOperation jobOperation,
EPrintXPSJobProgress jobProgress
);
Параметры
-
printerHandle [in]
-
Дескриптор принтера, для которого функция получает сведения. Используйте функцию OpenPrinter или AddPrinter , чтобы получить дескриптор принтера.
-
jobId [in]
-
Определяет задание печати, для которого требуется получить данные. Используйте функцию AddJob или функцию StartDoc , чтобы получить идентификатор задания печати.
-
jobOperation
-
Указывает, находится ли задание на этапе очереди или на этапе отрисовки.
-
jobProgress
-
Указывает, какая часть обработки выполняется в данный момент. Это значение относится к событиям на этапе очереди или отрисовки в зависимости от значения jobOperation.
Возвращаемое значение
Если операция выполнена успешно, возвращаемое значение S_OK, в противном случае HRESULT будет содержать код ошибки.
Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок.
Комментарии
Примечание
Это блокирующая или синхронная функция, возвращаемая не сразу. Скорость возврата этой функции зависит от факторов времени выполнения, таких как состояние сети, конфигурация сервера печати и факторы реализации драйвера принтера, которые трудно предсказать при написании приложения. Вызов этой функции из потока, который управляет взаимодействием с пользовательским интерфейсом, может привести к тому, что приложение не отвечает.
Примечание
ReportJobProcessingProgress будет сообщать о ходе выполнения задания печати XPS, только если задание печати находится на этапе очереди или отрисовки. ReportJobProcessingProgress завершится ошибкой , если он вызывается, когда задание печати XPS не находится на этапе очереди или отрисовки.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows Vista [только классические приложения] |
Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
Заголовок |
|
Библиотека |
|
DLL |
|