Structure des informations de travail _ _ 2

La structure _ informations _ sur le travail 2 décrit un jeu 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 tâche.

pPrinterName

Pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom de l’imprimante pour laquelle le travail est mis en attente.

pMachineName

Pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom de l’ordinateur qui a créé le travail d’impression.

pUserName

Pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom de l’utilisateur propriétaire du travail d’impression.

pDocument

Pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom du travail d’impression (par exemple, "MS-WORD : Review.doc").

pNotifyName

Pointeur vers une chaîne se terminant par un caractère 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 se terminant par un caractère null qui spécifie le type de données utilisé pour enregistrer le travail d’impression.

pPrintProcessor

Pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom du processeur d’impression qui doit être utilisé pour imprimer le travail.

pParameters

Pointeur vers une chaîne se terminant par un caractère null qui spécifie les paramètres du processeur d’impression.

pDriverName

Pointeur vers une chaîne se terminant par un caractère 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 les données d’initialisation et d’environnement de l’appareil pour le pilote d’imprimante.

pStatus

Pointeur vers une chaîne se terminant par un caractère null qui spécifie l’état du travail d’impression. Ce membre doit être vérifié avant l' État et, si PStatus a la valeur 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étrage 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
État du travail _ _ bloqué _ DEVQ Le pilote ne peut pas imprimer le travail.
État du travail _ _ supprimé La tâche a été supprimée.
suppression de l’état du travail _ _ Le travail est en cours de suppression.
_erreur d’état de la tâche _ Une erreur est associée au travail.
État du travail _ _ hors connexion L’imprimante est hors connexion.
_PAPEROUT État du travail _ L’imprimante n’est plus imprimée.
État du travail _ _ suspendu Le travail est suspendu.
État du travail _ _ imprimé Le travail a été imprimé.
_impression de l’état du travail _ Le travail est en cours d’impression.
redémarrage de l’état du travail _ _ Le travail a été redémarré.
mise en file d’attente de l’état du travail _ _ Le travail est en attente.
INTERVENTION de l’utilisateur de l’état du travail _ _ _ L’imprimante a une erreur qui nécessite que l’utilisateur effectue une action.

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

Valeur Signification
État du travail _ _ terminé Le travail est envoyé à l’imprimante, mais il n’est peut-être pas encore imprimé. Pour plus d'informations, consultez la section Notes.
État du travail _ _ conservé La tâche a été conservée dans la file d’attente à l’impression après l’impression.

Priorité

Priorité du travail. Ce membre peut être l’une des valeurs suivantes ou se trouver dans la plage comprise entre 1 et 99 ( _ Priorité minimale via _ priorité maximale).

Valeur Signification
priorité MIN. _ Priorité minimale.
priorité MAX. _ Priorité maximale.
priorité de définition _ Priorité par défaut.

Position

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

StartTime

Heure à laquelle le travail peut être imprimé au plus tôt.

UntilTime

Heure à laquelle le travail peut être imprimé au plus tard.

TotalPages

Nombre de pages requises pour le travail. Cette valeur peut être égale à zéro si le travail 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é envoyé.

Cette valeur de date/heure est au format UTC (Universal Time Coordinate). Vous devez la convertir en une 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.

Remarques

Les moniteurs de port qui ne prennent pas en charge TrueEndOfJob définissent le travail en tant qu’État du travail _ _ imprimé 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
_ _ Informations sur _ le travail 2S (Unicode) et _ _ informations sur les travaux _ 2A (ANSI)

Voir aussi

Impression

Structures de l’API du spouleur d’impression

DEVMODE

EnumJobs

GetJob

SetJob