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