Partager via


structure PRINTER_NOTIFY_INFO_DATA

La structure PRINTER_NOTIFY_INFO_DATA identifie un champ d’informations sur un travail ou une imprimante et fournit les données actuelles pour ce champ.

La fonction FindNextPrinterChangeNotification retourne une structure PRINTER_NOTIFY_INFO , qui contient un tableau de structures PRINTER_NOTIFY_INFO_DATA .

Syntaxe

typedef struct _PRINTER_NOTIFY_INFO_DATA {
  WORD  Type;
  WORD  Field;
  DWORD Reserved;
  DWORD Id;
  union {
    DWORD  adwData[2];
    struct {
      DWORD  cbBuf;
      LPVOID pBuf;
    } Data;
  } NotifyData;
} PRINTER_NOTIFY_INFO_DATA, *PPRINTER_NOTIFY_INFO_DATA; ;

Membres

Type

Indique le type d’informations fournies. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
JOB_NOTIFY_TYPE
0x01
Indique que le membre Field spécifie une constante JOB_NOTIFY_FIELD_*.
PRINTER_NOTIFY_TYPE
0x00
Indique que le membre Field spécifie une constante PRINTER_NOTIFY_FIELD_*.

Champ

Indique le champ qui a changé. Pour obtenir la liste des valeurs possibles, consultez la section Remarques.

Reserved

Réservé.

Id

Indique l’identificateur du travail si le membre Type spécifie JOB_NOTIFY_TYPE. Si le membre Type spécifie PRINTER_NOTIFY_TYPE, ce membre n’est pas défini.

NotifyData

Union d’informations de données basée sur les membres Type et Field . Pour obtenir une description du type de données associé à chaque champ, consultez la section Remarques.

adwData[2]

Tableau de deux valeurs DWORD . Pour les champs d’informations qui n’utilisent qu’un seul DWORD, les données sont dans adwData [0].

Données

cbBuf

Indique la taille, en octets, de la mémoire tampon pointée vers pBuf.

pBuf

Pointeur vers une mémoire tampon qui contient les données actuelles du champ.

Notes

Si le membre Type spécifie PRINTER_NOTIFY_TYPE, le membre Field peut être l’une des valeurs suivantes.

Champ Type de données Valeur
PRINTER_NOTIFY_FIELD_SERVER_NAME Non pris en charge. 0x00
PRINTER_NOTIFY_FIELD_PRINTER_NAME pBuf est un pointeur vers une chaîne terminée par null contenant le nom de l’imprimante. 0x01
PRINTER_NOTIFY_FIELD_SHARE_NAME pBuf est un pointeur vers une chaîne terminée par null qui identifie le point de partage de l’imprimante. 0x02
PRINTER_NOTIFY_FIELD_PORT_NAME pBuf est un pointeur vers une chaîne terminée par null contenant le nom du port sur lequel les travaux d’impression seront imprimés. Si « Regroupement d’imprimantes » est sélectionné, il s’agit d’une liste de ports séparés par des virgules. 0x03
PRINTER_NOTIFY_FIELD_DRIVER_NAME pBuf est un pointeur vers une chaîne terminée par null contenant le nom du pilote de l’imprimante. 0x04
PRINTER_NOTIFY_FIELD_COMMENT pBuf est un pointeur vers une chaîne terminée par null contenant la nouvelle chaîne de commentaire, qui est généralement une brève description de l’imprimante. 0x05
PRINTER_NOTIFY_FIELD_LOCATION pBuf est un pointeur vers une chaîne terminée par null contenant le nouvel emplacement physique de l’imprimante (par exemple, « Bldg. 38, Salle 1164 »). 0x06
PRINTER_NOTIFY_FIELD_DEVMODE pBuf est un pointeur vers une structure DEVMODE qui définit les données d’imprimante par défaut telles que l’orientation du papier et la résolution. 0x07
PRINTER_NOTIFY_FIELD_SEPFILE pBuf est un pointeur vers une chaîne terminée par null qui spécifie le nom du fichier utilisé pour créer la page de séparateur. Cette page est utilisée pour séparer les travaux d’impression envoyés à l’imprimante. 0x08
PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR pBuf est un pointeur vers une chaîne terminée par null qui spécifie le nom du processeur d’impression utilisé par l’imprimante. 0x09
PRINTER_NOTIFY_FIELD_PARAMETERS pBuf est un pointeur vers une chaîne terminée par null qui spécifie les paramètres par défaut du processeur d’impression. 0x0A
PRINTER_NOTIFY_FIELD_DATATYPE pBuf est un pointeur vers une chaîne terminée par null qui spécifie le type de données utilisé pour enregistrer le travail d’impression. 0x0B
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR pBuf est un pointeur vers une structure SECURITY_DESCRIPTOR pour l’imprimante. Le pointeur peut avoir la valeur NULL s’il n’existe aucun descripteur de sécurité. 0x0C
PRINTER_NOTIFY_FIELD_ATTRIBUTES adwData [0] spécifie les attributs d’imprimante, qui peuvent être l’une des valeurs suivantes :
PRINTER_ATTRIBUTE_QUEUED
PRINTER_ATTRIBUTE_DIRECT
PRINTER_ATTRIBUTE_DEFAULT
PRINTER_ATTRIBUTE_SHARED
0x0D
PRINTER_NOTIFY_FIELD_PRIORITY adwData [0] spécifie une valeur de priorité que le spouleur utilise pour acheminer les travaux d’impression. 0x0E
PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY adwData [0] spécifie la valeur de priorité par défaut affectée à chaque travail d’impression. 0x0F
PRINTER_NOTIFY_FIELD_START_TIME adwData [0] spécifie le moment le plus précoce auquel l’imprimante imprimera un travail. (Cette valeur est spécifiée en minutes écoulées depuis 12h00) 0x10
PRINTER_NOTIFY_FIELD_UNTIL_TIME adwData [0] spécifie l’heure à laquelle l’imprimante imprimera un travail. (Cette valeur est spécifiée en minutes écoulées depuis 12:00) 0x11
PRINTER_NOTIFY_FIELD_STATUS adwData [0] spécifie l’imprimante status. Pour obtenir la liste des valeurs possibles, consultez la structure PRINTER_INFO_2 . 0x12
PRINTER_NOTIFY_FIELD_STATUS_STRING Non pris en charge. 0x13
PRINTER_NOTIFY_FIELD_CJOBS adwData [0] spécifie le nombre de travaux d’impression qui ont été mis en file d’attente pour l’imprimante. 0x14
PRINTER_NOTIFY_FIELD_AVERAGE_PPM adwData [0] spécifie le nombre moyen de pages par minute qui ont été imprimées sur l’imprimante. 0x15
PRINTER_NOTIFY_FIELD_TOTAL_PAGES Non pris en charge. 0x16
PRINTER_NOTIFY_FIELD_PAGES_PRINTED Non pris en charge. 0x17
PRINTER_NOTIFY_FIELD_TOTAL_BYTES Non pris en charge. 0x18
PRINTER_NOTIFY_FIELD_BYTES_PRINTED Non pris en charge. 0x19
PRINTER_NOTIFY_FIELD_OBJECT_GUID Cette valeur est définie si le GUID de l’objet change. 0x1A
PRINTER_NOTIFY_FIELD_FRIENDLY_NAME Cette valeur est définie si la connexion d’imprimante est renommée. 0x1B

Si le membre Type spécifie JOB_NOTIFY_TYPE, le membre Field peut être l’une des valeurs suivantes.

Champ Type de données Valeur
JOB_NOTIFY_FIELD_PRINTER_NAME pBuf est un pointeur vers une chaîne terminée par null contenant le nom de l’imprimante pour laquelle le travail est mis en pool. 0x00
JOB_NOTIFY_FIELD_MACHINE_NAME pBuf est un pointeur vers une chaîne terminée par null qui spécifie le nom de l’ordinateur qui a créé le travail d’impression. 0x01
JOB_NOTIFY_FIELD_PORT_NAME pBuf est un pointeur vers une chaîne terminée par null qui identifie le ou les ports utilisés pour transmettre des données à l’imprimante. Si une imprimante est connectée à plusieurs ports, les noms des ports sont séparés par des virgules (par exemple, « LPT1:,LPT2:,LPT3: »). 0x02
JOB_NOTIFY_FIELD_USER_NAME pBuf est un pointeur vers une chaîne terminée par null qui spécifie le nom de l’utilisateur qui a envoyé le travail d’impression. 0x03
JOB_NOTIFY_FIELD_NOTIFY_NAME pBuf est un 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. 0x04
JOB_NOTIFY_FIELD_DATATYPE pBuf est un pointeur vers une chaîne terminée par null qui spécifie le type de données utilisé pour enregistrer le travail d’impression. 0x05
JOB_NOTIFY_FIELD_PRINT_PROCESSOR pBuf est un pointeur vers une chaîne terminée par null qui spécifie le nom du processeur d’impression à utiliser pour imprimer le travail. 0x06
JOB_NOTIFY_FIELD_PARAMETERS pBuf est un pointeur vers une chaîne terminée par null qui spécifie les paramètres du processeur d’impression. 0x07
JOB_NOTIFY_FIELD_DRIVER_NAME pBuf est un 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. 0x08
JOB_NOTIFY_FIELD_DEVMODE pBuf est un pointeur vers une structure DEVMODE qui contient des données d’initialisation de périphérique et d’environnement pour le pilote d’imprimante. 0x09
JOB_NOTIFY_FIELD_STATUS adwData [0] spécifie le travail status. Pour obtenir la liste des valeurs possibles, consultez la structure JOB_INFO_2 . 0x0A
JOB_NOTIFY_FIELD_STATUS_STRING pBuf est un pointeur vers une chaîne terminée par null qui spécifie le status du travail d’impression. 0x0B
JOB_NOTIFY_FIELD_SECURITY_DESCRIPTOR Non pris en charge. 0x0C
JOB_NOTIFY_FIELD_DOCUMENT pBuf est un pointeur vers une chaîne terminée par null qui spécifie le nom du travail d’impression (par exemple, « MS-WORD : Review.doc »). 0x0D
JOB_NOTIFY_FIELD_PRIORITY adwData [0] spécifie la priorité du travail. 0x0E
JOB_NOTIFY_FIELD_POSITION adwData [0] spécifie la position du travail dans la file d’attente d’impression. 0x0F
JOB_NOTIFY_FIELD_SUBMITTED pBuf est un pointeur vers une structure SYSTEMTIME qui spécifie l’heure à laquelle le travail a été soumis. 0x10
JOB_NOTIFY_FIELD_START_TIME adwData [0] spécifie l’heure à laquelle le travail peut être imprimé le plus tôt possible. (Cette valeur est spécifiée en minutes écoulées depuis 12:00) 0x11
JOB_NOTIFY_FIELD_UNTIL_TIME adwData [0] spécifie la dernière heure à laquelle le travail peut être imprimé. (Cette valeur est spécifiée en minutes écoulées depuis 12:00) 0x12
JOB_NOTIFY_FIELD_TIME adwData [0] spécifie le temps total, en secondes, qui s’est écoulé depuis le début de l’impression du travail. 0x13
JOB_NOTIFY_FIELD_TOTAL_PAGES adwData [0] spécifie la taille, en pages, du travail. 0x14
JOB_NOTIFY_FIELD_PAGES_PRINTED adwData [0] spécifie le nombre de pages imprimées. 0x15
JOB_NOTIFY_FIELD_TOTAL_BYTES adwData [0] spécifie la taille, en octets, du travail. 0x16
JOB_NOTIFY_FIELD_BYTES_PRINTED adwData [0] spécifie le nombre d’octets qui ont été imprimés sur ce travail. Pour ce champ, l’objet de notification de modification est signalé lorsque des octets sont envoyés à l’imprimante. 0x17

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)

Voir aussi

Impression

Imprimer les structures de l’API spouleur

DEVMODE

FindNextPrinterChangeNotification

JOB_INFO_2

PRINTER_INFO_2

PRINTER_NOTIFY_INFO

SECURITY_DESCRIPTOR

SYSTEMTIME