Метод IXpsPrintJob::GetJobStatus (xpsprint.h)
[IXpsPrintJob::GetJobSatus не поддерживается и может быть изменен или недоступен в будущем. ]
Получает текущее состояние задания печати.
Синтаксис
HRESULT GetJobStatus(
[out, retval] XPS_JOB_STATUS *jobStatus
);
Параметры
[out, retval] jobStatus
Текущее состояние задания печати. Сведения о данных, возвращаемых в этой структуре, см. в разделе XPS_JOB_STATUS.
Возвращаемое значение
Если метод завершается успешно, он возвращает S_OK; В противном случае возвращается код ошибки HRESULT .
Комментарии
GetJobStatus может вызываться во время обработки задания печати или после завершения задания печати. Значения, возвращаемые в XPS_JOB_STATUS представляют текущее состояние задания печати на момент вызова GetJobStatus , поэтому между вызовами этого метода можно пропустить промежуточные состояния.
Значения jobStatus.currentDocument и jobStatus.currentPage гарантированно будут выполняться последовательно: от первого документа к последнему и от первой страницы до последнего в каждом документе.
Идентификатор задания печати, отправленного в microsoft XPS Document Writer (MXDW), равен нулю. Если интерфейс соответствует интерфейсу задания печати, отправленного в MXDW, в jobStatus.jobId будет возвращен ноль.
Если заданию печати не назначен ни один идентификатор задания или задание печати печатается без очереди, в jobStatus.jobId будет возвращен ноль.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | xpsprint.h |