structure JOB_INFO_2

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 enpool.

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é 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 la tâche d’impression.

pDevMode

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

pStatus

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

pSecurityDescriptor

La valeur de ce membre est NULL. La récupération et le paramètre des descripteurs de sécurité de document ne sont pas pris en charge dans cette version.

État

État du travail. 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 supprimé.
JOB_STATUS_ERROR Une erreur est associée au travail.
JOB_STATUS_OFFLINE L’imprimante est hors connexion.
JOB_STATUS_PAPEROUT L’imprimante est hors 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 enpooling.
JOB_STATUS_USER_INTERVENTION L’imprimante a 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 peut ne pas encore être imprimé. Pour plus d'informations, consultez la section Notes.
JOB_STATUS_RETAINED Le travail a été conservé dans la file d’attente d’impression suivant 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

La première fois que le travail peut être imprimé.

UntilTime

Dernière fois que le travail peut être imprimé.

TotalPages

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

Taille

Taille, en octets, du travail.

Envoyée

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

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

Time

Temps total, en millisecondes, qui s’est écoulé depuis le début de l’impression du travail.

PagesPrinted

Nombre de pages imprimées. Cette valeur peut être zéro si le travail d’impression ne contient pas d’informations de 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.

Configuration requise

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 Spooler

DEVMODE

EnumJobs

GetJob

SetJob