_Structure de _ données d’informations de notification d’imprimante _

La structure de _ _ _ données d’informations de notification d’imprimante identifie un champ de travail ou d’informations sur l’imprimante et fournit les données actuelles pour ce champ.

La fonction FindNextPrinterChangeNotification retourne une structure d' _ _ informations de notification d’imprimante , qui contient un tableau de structures de _ _ _ données d’informations de notification d’imprimante .

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
Travail _ _Type de notification
0x01
Indique que le membre champ spécifie une _ constante de champ de notification de travail _ _ * .
Imprimante _ _Type de notification
0x00
Indique que le membre champ spécifie une _ constante de champ de notification d’imprimante _ _ * .

Champ

Indique le champ qui a été modifié. Pour obtenir la liste des valeurs possibles, consultez la section Notes.

Reserved

Réservé.

Id

Indique l’identificateur du travail si le membre du type spécifie le type de notification du travail _ _ . Si le membre de type spécifie le _ type de notification d’imprimante _ , ce membre n’est pas défini.

NotifyData

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

adwData [ 2]

Tableau de deux valeurs DWORD . Pour les champs d’informations qui n’utilisent qu’une seule valeur DWORD, les données se trouvent dans adwData [ 0 ] .

Données

cbBuf

Indique la taille, en octets, de la mémoire tampon vers laquelle pointe pBuf.

pBuf

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

Remarques

Si le membre de type spécifie le _ type de notification d’imprimante _ , le membre de champ peut prendre 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 se terminant par un caractère null qui contient le nom de l’imprimante. 0x01
PRINTER_NOTIFY_FIELD_SHARE_NAME pBuf est un pointeur vers une chaîne se terminant par un caractère null qui identifie le point de partage de l’imprimante. 0x02
PRINTER_NOTIFY_FIELD_PORT_NAME pBuf est un pointeur vers une chaîne se terminant par un caractère null qui contient le nom du port sur lequel les travaux d’impression seront imprimés. Si " " le 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 se terminant par un caractère null qui contient le nom du pilote de l’imprimante. 0x04
PRINTER_NOTIFY_FIELD_COMMENT pBuf est un pointeur vers une chaîne se terminant par un caractère null qui contient 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 se terminant par un caractère null qui contient 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 se terminant par un caractère null qui spécifie le nom du fichier utilisé pour créer la page de séparation. 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 se terminant par un caractère 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 se terminant par un caractère null qui spécifie les paramètres du processeur d’impression par défaut. 0x0A
PRINTER_NOTIFY_FIELD_DATATYPE pBuf est un 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. 0x0B
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR pBuf est un pointeur vers une structure SECURITY_DESCRIPTOR pour l’imprimante. Le pointeur peut être 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 router 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 l’heure la plus ancienne à laquelle l’imprimante imprime un travail. (Cette valeur est spécifiée en minutes écoulées depuis 12:00 heures) 0x10
PRINTER_NOTIFY_FIELD_UNTIL_TIME adwData [0] spécifie l’heure la plus récente à laquelle l’imprimante imprime un travail. (Cette valeur est spécifiée en minutes écoulées depuis 12:00 heures) 0x11
PRINTER_NOTIFY_FIELD_STATUS adwData [0] spécifie l’état de l’imprimante. 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 à l’imprimante est renommée. 0x1B

Si le membre de type spécifie le _ type de notification de travail _ , le membre de champ peut être l’une des valeurs suivantes.

Champ Type de données Valeur
nom de l’imprimante du champ de _ notification du travail _ _ _ pBuf est un pointeur vers une chaîne se terminant par un caractère null qui contient le nom de l’imprimante pour laquelle la tâche est mise en attente. 0x00
_nom d' _ ordinateur du champ de notification du travail _ _ pBuf est un 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. 0x01
_nom du _ port du champ de notification du travail _ _ pBuf est un pointeur vers une chaîne se terminant par un caractère 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
_nom d' _ utilisateur du champ de notification du travail _ _ pBuf est un pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom de l’utilisateur qui a envoyé le travail d’impression. 0x03
_nom du _ champ _ NOTIFIer le travail _ pBuf est un 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. 0x04
_type de _ données du champ de notification du travail _ pBuf est un 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. 0x05
_processeur d' _ impression du champ de notification du travail _ _ pBuf est un pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom du processeur d’impression à utiliser pour imprimer le travail. 0x06
_paramètres du _ champ de notification du travail _ pBuf est un pointeur vers une chaîne se terminant par un caractère null qui spécifie les paramètres du processeur d’impression. 0x07
_nom du _ pilote du champ de notification du travail _ _ pBuf est un 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. 0x08
champ de notification de tâche _ _ _ DEVMODE pBuf est un pointeur vers une structure DEVMODE qui contient des données d’initialisation d’appareil et d’environnement pour le pilote d’imprimante. 0x09
_État du _ champ de notification du travail _ adwData [ 0 ] spécifie l’état du travail. Pour obtenir la liste des valeurs possibles, consultez la structure Job _ info _ 2 . 0x0A
_chaîne d' _ État du champ de notification du travail _ _ pBuf est un pointeur vers une chaîne se terminant par un caractère null qui spécifie l’état du travail d’impression. 0x0B
_descripteur de sécurité de champ de notification de travail _ _ _ Non pris en charge. 0x0C
_document de _ champ de notification de tâche _ pBuf est un 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 »). 0x0D
_priorité du _ champ de notification du travail _ adwData [ 0 ] spécifie la priorité du travail. 0x0E
_position du _ champ de notification du travail _ adwData [ 0 ] spécifie la position du travail dans la file d’attente à l’impression. 0x0F
champ de notification de travail _ _ _ envoyé pBuf est un pointeur vers une structure SystemTime qui spécifie l’heure à laquelle le travail a été soumis. 0x10
_heure de _ début du champ de notification du travail _ _ adwData [ 0 ] spécifie l’heure à laquelle le travail peut être imprimé au plus tôt. (Cette valeur est spécifiée en minutes écoulées depuis 12:00 heures) 0x11
champ de notification du travail _ _ _ jusqu’à l' _ heure adwData [ 0 ] spécifie l’heure à laquelle le travail peut être imprimé au plus tard. (Cette valeur est spécifiée en minutes écoulées depuis 12:00 heures) 0x12
_heure du _ champ de notification du travail _ adwData [ 0 ] spécifie la durée totale, en secondes, qui s’est écoulée depuis le début de l’impression du travail. 0x13
_ _ _ nombre total de _ pages du champ notifier le travail adwData [ 0 ] spécifie la taille, en pages, du travail. 0x14
PAGES de champs de notification de travail _ _ _ _ imprimées adwData [ 0 ] spécifie le nombre de pages qui ont été imprimées. 0x15
champ de notification du travail- _ _ _ nombre total d' _ octets adwData [ 0 ] spécifie la taille, en octets, du travail. 0x16
octets du champ de notification du travail _ _ _ _ imprimés 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

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)

Voir aussi

Impression

Structures de l’API du spouleur d’impression

DEVMODE

FindNextPrinterChangeNotification

_Informations sur le travail _ 2

_Infos sur l’imprimante _ 2

_informations de notification de l’imprimante _

descripteur de sécurité _

SYSTEMTIME