Метод IXpsPrintJob::GetJobStatus (xpsprint.h)

Статья
08/28/2023

[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