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

  • Article

[IXpsPrintJob ::GetJobSatus n’est pas pris en charge et peut être modifié ou indisponible à l’avenir. ]

Obtient l'état actuel du travail d'impression.

Syntaxe

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

Paramètres

[out, retval] jobStatus

La status actuelle du travail d’impression. Pour plus d’informations sur les données retournées dans cette structure, consultez XPS_JOB_STATUS.

Valeur retournée

Si la méthode réussit, elle retourne S_OK ; sinon, elle retourne un code d’erreur HRESULT .

Remarques

GetJobStatus peut être appelé pendant le traitement du travail d’impression ou une fois le travail d’impression terminé. Les valeurs retournées dans XPS_JOB_STATUS représentent l’état actuel du travail d’impression au moment où GetJobStatus est appelé. Il est donc possible d’manquer des états intermédiaires entre les appels à cette méthode.

Les valeurs de jobStatus.currentDocument et jobStatus.currentPage sont garanties pour progresser de manière séquentielle : du premier au dernier document, et de la première page à la dernière dans chaque document.

L’ID de travail d’un travail d’impression qui a été envoyé à l’enregistreur de documents Microsoft XPS (MXDW) est égal à zéro. Si l’interface est celle d’un travail d’impression qui a été envoyé au MXDW, zéro est retourné dans jobStatus.jobId.

Si aucun ID de travail n’a été affecté au travail d’impression ou si le travail d’impression est imprimé sans mise en attente, zéro est retourné dans jobStatus.jobId.

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête xpsprint.h

Voir aussi

Documents

IXpsPrintJob

XML Paper Specification

XPS_JOB_COMPLETION

XPS_JOB_STATUS