structure JOB_INFO_2

Article
06/12/2023

La structure JOB_INFO_2 décrit un ensemble complet de valeurs associées à un travail.

Syntaxe

typedef struct _JOB_INFO_2 {
  DWORD                JobId;
  LPTSTR               pPrinterName;
  LPTSTR               pMachineName;
  LPTSTR               pUserName;
  LPTSTR               pDocument;
  LPTSTR               pNotifyName;
  LPTSTR               pDatatype;
  LPTSTR               pPrintProcessor;
  LPTSTR               pParameters;
  LPTSTR               pDriverName;
  LPDEVMODE            pDevMode;
  LPTSTR               pStatus;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Status;
  DWORD                Priority;
  DWORD                Position;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                TotalPages;
  DWORD                Size;
  SYSTEMTIME           Submitted;
  DWORD                Time;
  DWORD                PagesPrinted;
} JOB_INFO_2, *PJOB_INFO_2;

Membres

JobId

Valeur d’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 »).

pNotifyName

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’utilisateur qui doit être averti lorsque le travail a été imprimé ou lorsqu’une erreur se produit lors de l’impression du travail.

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.

pPrintProcessor

Pointeur vers une chaîne terminée par null qui spécifie le nom du processeur d’impression qui doit être utilisé pour imprimer le travail.

pParameters

Pointeur vers une chaîne terminée par null qui spécifie les paramètres du processeur d’impression.

pDriverName

Pointeur vers une chaîne terminée par null qui spécifie le nom du pilote d’imprimante qui doit être utilisé pour traiter le travail d’impression.

pDevMode

Pointeur vers une structure DEVMODE qui contient des données d’initialisation de périphérique et d’environnement pour le pilote d’imprimante.

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.

pSecurityDescriptor

La valeur de ce membre est NULL. La récupération et la définition des descripteurs de sécurité des documents ne sont pas prises en charge dans cette version.

État

Le travail status. Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
JOB_STATUS_BLOCKED_DEVQ	Le pilote ne peut pas imprimer le travail.
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_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.

Dans Windows XP et les versions ultérieures de Windows, les valeurs suivantes peuvent également être utilisées :

Valeur	Signification
JOB_STATUS_COMPLETE	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_RETAINED	Le travail a été conservé dans la file d’attente d’impression après l’impression.

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.

StartTime

Date d’impression la plus précoce du travail.

UntilTime

Dernière heure à laquelle le travail peut être imprimé.

TotalPages

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

Taille

Taille, en octets, du travail.

Envoyée

Structure SYSTEMTIME qui spécifie l’heure à laquelle le travail a été soumis.

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.

Time

Durée totale, en millisecondes, qui s’est écoulée depuis le début de l’impression du travail.

PagesPrinted

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

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_2W (Unicode) et _JOB_INFO_2A (ANSI)

Voir aussi

Impression
Imprimer les structures de l’API spouleur
DEVMODE
EnumJobs
GetJob
SetJob

Partager via