structure JOB_INFO_1

Article
06/12/2023

La structure JOB_INFO_1 spécifie des informations de travail d’impression telles que la valeur de l’identificateur de travail, le nom de l’imprimante pour laquelle le travail est mis en pool, le nom de l’ordinateur qui a créé le travail d’impression, le nom de l’utilisateur propriétaire du travail d’impression, etc.

Syntaxe

typedef struct _JOB_INFO_1 {
  DWORD      JobId;
  LPTSTR     pPrinterName;
  LPTSTR     pMachineName;
  LPTSTR     pUserName;
  LPTSTR     pDocument;
  LPTSTR     pDatatype;
  LPTSTR     pStatus;
  DWORD      Status;
  DWORD      Priority;
  DWORD      Position;
  DWORD      TotalPages;
  DWORD      PagesPrinted;
  SYSTEMTIME Submitted;
} JOB_INFO_1, *PJOB_INFO_1;

Membres

JobId

Identificateur de travail.

pPrinterName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’imprimante pour laquelle le travail est mis en file d’attente.

pMachineName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’ordinateur qui a créé le travail d’impression.

pUserName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’utilisateur propriétaire du travail d’impression.

pDocument

Pointeur vers une chaîne terminée par null qui spécifie le nom du travail d’impression (par exemple, « MS-WORD : Review.doc »).

pDatatype

Pointeur vers une chaîne terminée par null qui spécifie le type de données utilisées pour enregistrer le travail d’impression.

pStatus

Pointeur vers une chaîne terminée par null qui spécifie le status du travail d’impression. Ce membre doit être vérifié avant Status et, si pStatus a la valeur NULL, le status est défini par le contenu du membre Status.

État

Le travail status. La valeur de ce membre peut être zéro ou une combinaison d’une ou plusieurs des valeurs suivantes. La valeur zéro indique que la file d’attente d’impression a été suspendue après la fin du spoulage du document.

Valeur	Signification
JOB_STATUS_BLOCKED_DEVQ	Le pilote ne peut pas imprimer le travail.
JOB_STATUS_COMPLETE	Windows XP et versions ultérieures : Le travail est envoyé à l’imprimante, mais il se peut qu’il ne soit pas encore imprimé. Pour plus d'informations, consultez la section Notes.
JOB_STATUS_DELETED	Le travail a été supprimé.
JOB_STATUS_DELETING	Le travail est en cours de suppression.
JOB_STATUS_ERROR	Une erreur est associée au travail.
JOB_STATUS_OFFLINE	L’imprimante est hors connexion.
JOB_STATUS_PAPEROUT	L’imprimante est en panne de papier.
JOB_STATUS_PAUSED	Le travail est suspendu.
JOB_STATUS_PRINTED	Le travail a été imprimé.
JOB_STATUS_PRINTING	Le travail est en cours d’impression.
JOB_STATUS_RESTART	Le travail a été redémarré.
JOB_STATUS_RETAINED	Windows Vista et versions ultérieures : Le travail a été conservé dans la file d’attente d’impression et ne peut pas être supprimé. Ceci peut être lié aux problèmes suivants : 1) Le travail a été conservé manuellement par un appel à SetJob et le spouleur attend que le travail soit libéré. 2) L’impression du travail n’est pas terminée et doit terminer l’impression avant de pouvoir être automatiquement supprimée. Pour plus d’informations sur les commandes de travail d’impression, consultez SetJob .
JOB_STATUS_SPOOLING	Le travail est en cours de mise en file d’attente.
JOB_STATUS_USER_INTERVENTION	L’imprimante présente une erreur qui oblige l’utilisateur à faire quelque chose.

Priorité

Priorité du travail. Ce membre peut être l’une des valeurs suivantes ou dans la plage comprise entre 1 et 99 (MIN_PRIORITY à MAX_PRIORITY).

Valeur	Signification
MIN_PRIORITY	Priorité minimale.
MAX_PRIORITY	Priorité maximale.
DEF_PRIORITY	Priorité par défaut.

Position

Position du travail dans la file d’attente d’impression.

TotalPages

Nombre total de pages que contient le document. Cette valeur peut être égale à zéro si la tâche d’impression ne contient pas d’informations de délimitation de page.

PagesPrinted

Nombre de pages imprimées. Cette valeur peut être égale à zéro si la tâche d’impression ne contient pas d’informations de délimitation de page.

Envoyée

Structure SYSTEMTIME qui spécifie l’heure à laquelle ce document a été mis en file d’attente.

Cette valeur d’heure est au format UTC (Universal Time Coordinate). Vous devez le convertir en valeur d’heure locale avant de l’afficher. Vous pouvez utiliser la fonction FileTimeToLocalFileTime pour effectuer la conversion.

Notes

Les moniteurs de port qui ne prennent pas en charge TrueEndOfJob définissent le travail comme JOB_STATUS_PRINTED juste après l’envoi du travail à l’imprimante.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Winspool.h (inclure Windows.h)
Noms Unicode et ANSI	_JOB_INFO_1W (Unicode) et _JOB_INFO_1A (ANSI)

Voir aussi

Impression
Structures de l’API spouleur d’impression
EnumJobs
GetJob
SetJob