PRINT_OTHER_INFO structure (lmalert.h)

Article
02/28/2024

La structure PRINT_OTHER_INFO contient des informations sur un travail d’impression. Les fonctions NetAlertRaise et NetAlertRaiseEx utilisent la structure PRINT_OTHER_INFO pour spécifier des informations lorsqu’un travail est terminé ou lorsqu’une imprimante a besoin d’une intervention.

Syntaxe

typedef struct _PRINT_OTHER_INFO {
  DWORD alrtpr_jobid;
  DWORD alrtpr_status;
  DWORD alrtpr_submitted;
  DWORD alrtpr_size;
} PRINT_OTHER_INFO, *PPRINT_OTHER_INFO, *LPPRINT_OTHER_INFO;

Membres

alrtpr_jobid

Type : DWORD

Numéro d’identification du travail d’impression.

alrtpr_status

Type : DWORD

Masque de bits décrivant la status du travail d’impression.

Vous pouvez obtenir la status globale du travail en vérifiant PRJOB_QSTATUS (bits 0 et 1).

Les valeurs possibles pour le travail d’impression status sont répertoriées dans le fichier d’en-tête Lmalert.h.

Valeur	Signification
PRJOB_QS_QUEUED 0	Le travail d’impression se trouve dans la file d’attente en attente de planification.
PRJOB_QS_PAUSED 1	Le travail d’impression se trouve dans la file d’attente, mais il a été suspendu. (Lorsqu’un travail est suspendu, il ne peut pas être planifié.)
PRJOB_QS_SPOOLING 2	Le travail d’impression est en cours de mise en file d’attente.
PRJOB_QS_PRINTING 3	Le travail est en cours d’impression.

Si le travail d’impression est dans l’état PRJOB_QS_PRINTING, vous pouvez case activée bits 2 à 8 pour le status (PRJOB_DEVSTATUS) de l’appareil. Bit 15 est également significatif.

Les valeurs possibles pour les status de l’appareil sont répertoriées dans le fichier d’en-tête Lmalert.h.

Valeur	Signification
PRJOB_COMPLETE 0x4	Le travail a terminé l’impression.
PRJOB_INTERV 0x8	L’imprimante de destination nécessite l’intervention d’un opérateur.
PRJOB_ERROR 0x10	Une erreur se produit au niveau de l’imprimante de destination.
PRJOB_DESTOFFLINE 0x20	L’imprimante de destination est hors connexion.
PRJOB_DESTPAUSED 0x40	L’imprimante de destination est suspendue.
PRJOB_NOTIFY 0x80	Une alerte d’impression doit être déclenchée.
PRJOB_DESTNOPAPER 0x100	L’imprimante de destination est en papier.
PRJOB_DELETED 0x8000	Le travail d’impression est en cours de suppression.

alrtpr_submitted

Type : DWORD

Heure à laquelle le travail d’impression a été envoyé. Cette valeur est stockée sous la forme du nombre de secondes écoulées depuis 00 :00 :00, le 1er janvier 1970, GMT.

alrtpr_size

Type : DWORD

Taille, en octets, du travail d’impression.

Remarques

Des données de longueur variable supplémentaires suivent la structure PRINT_OTHER_INFO dans la mémoire tampon des messages d’alerte. Les informations sont sous la forme de chaînes de caractères contiguës terminées par un caractère Null, comme suit.

String	Signification
computername	Ordinateur qui a envoyé le travail d’impression.
username	Utilisateur qui a envoyé le travail d’impression.
queuename	File d’attente d’impression à laquelle le travail a été envoyé.
destination	Destination de l’imprimante (appareil) vers lequel le travail d’impression a été routé.
status	Status du travail d’impression.

L’application appelante doit allouer et libérer la mémoire pour toutes les structures et données de longueur variable dans une mémoire tampon de messages d’alerte.

Consultez NetAlertRaiseEx pour obtenir un exemple de code qui montre comment déclencher une alerte d’impression.

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	lmalert.h (include Lm.h)