Méthode IXpsPrintJob ::GetJobStatus (xpsprint.h)
[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 |