Método IXpsPrintJob::GetJobStatus (xpsprint.h)

[IXpsPrintJob::GetJobSatus não tem suporte e pode ser alterado ou indisponível no futuro. ]

Obtém o status atual do trabalho de impressão.

Sintaxe

HRESULT GetJobStatus(
  [out, retval] XPS_JOB_STATUS *jobStatus
);

Parâmetros

[out, retval] jobStatus

O status atual do trabalho de impressão. Para obter informações sobre os dados retornados nessa estrutura, consulte XPS_JOB_STATUS.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará um código de erro HRESULT .

Comentários

GetJobStatus pode ser chamado durante o processamento do trabalho de impressão ou após a conclusão do trabalho de impressão. Os valores retornados em XPS_JOB_STATUS representam o estado atual do trabalho de impressão no momento em que GetJobStatus é chamado, portanto, é possível perder estados intermediários entre chamadas para esse método.

Os valores de jobStatus.currentDocument e jobStatus.currentPage têm a garantia de progredir sequencialmente: do primeiro ao último documento e da primeira à última página em cada documento.

A ID de trabalho de um trabalho de impressão que foi enviado para o MXDW (Gravador de Documentos XPS da Microsoft) é zero. Se a interface for a de um trabalho de impressão que foi enviado para o MXDW, zero será retornado em jobStatus.jobId.

Se nenhuma ID de trabalho tiver sido atribuída ao trabalho de impressão ou o trabalho de impressão for impresso sem spooling, zero será retornado em jobStatus.jobId.

Requisitos

Confira também

Documentos

IXpsPrintJob

Especificação de Papel XML

XPS_JOB_COMPLETION

XPS_JOB_STATUS