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_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 |
|