JOB_INFO_4 structure
Décrit un ensemble complet de valeurs associées à un travail et prend en charge les fichiers spool volumineux avec des tailles exprimées avec 64 bits.
Syntaxe
typedef struct _JOB_INFO_4 {
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;
LONG SizeHigh;
} JOB_INFO_4, *PJOB_INFO_4;
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 pool.
-
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 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 terminée par null qui spécifie le nom de l’utilisateur qui doit être averti quand 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 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é de document 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 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 mis en file d’attente. JOB_STATUS_USER_INTERVENTION L’imprimante contient une erreur qui oblige l’utilisateur à effectuer une action. 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 n’est peut-être 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
-
Heure à laquelle le travail peut être imprimé le plus tôt possible.
-
UntilTime
-
Heure la plus récente à laquelle le travail peut être imprimé.
-
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
-
Les quatre octets inférieurs de la taille, en octets, du travail. Consultez également le membre SizeHigh ci-dessous.
-
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 Coordonnée). 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.
-
SizeHigh
-
Quatre octets plus élevés de la taille, en octets, du travail. Consultez également le membre Size ci-dessus.
Notes
Les moniteurs de port qui ne prennent pas en charge TrueEndOfJob définissent le travail comme JOB_STATUS_PRINTED immédiatement 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 |
|
| Noms Unicode et ANSI |
_JOB_INFO_4W (Unicode) et _JOB_INFO_4A (ANSI) |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour