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

  • Artículo

[IXpsPrintJob::GetJobSatus no se admite y puede modificarse o no estar disponible en el futuro. ]

Obtiene el estado actual del trabajo de impresión.

Sintaxis

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

Parámetros

[out, retval] jobStatus

Estado actual del trabajo de impresión. Para obtener información sobre los datos que se devuelven en esta estructura, consulte XPS_JOB_STATUS.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error HRESULT .

Comentarios

Se puede llamar a GetJobStatus durante el procesamiento del trabajo de impresión o después de que se haya completado el trabajo de impresión. Los valores devueltos en XPS_JOB_STATUS representan el estado actual del trabajo de impresión en el momento en que se llama a GetJobStatus , por lo que es posible perder los estados intermedios entre las llamadas a este método.

Se garantiza que los valores de jobStatus.currentDocument y jobStatus.currentPage progresan secuencialmente: desde el primer documento hasta el último y desde la primera página hasta la última dentro de cada documento.

El identificador de trabajo de un trabajo de impresión que se ha enviado al Escritor de documentos de Microsoft XPS (MXDW) es cero. Si la interfaz es la de un trabajo de impresión que se ha enviado a MXDW, cero se devolverá en jobStatus.jobId.

Si no se ha asignado ningún identificador de trabajo al trabajo de impresión o el trabajo de impresión se imprime sin colas, cero se devolverá en jobStatus.jobId.

Requisitos

   
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado xpsprint.h

Vea también

Documentos

IXpsPrintJob

XML Paper Specification

XPS_JOB_COMPLETION

XPS_JOB_STATUS