_Classe PrintJob Win32
la classe WMI _ PrintJob Win32 représente un travail d’impression généré par une application Windows. toute unité de travail générée par la commande d’impression d’une application exécutée sur un ordinateur qui exécute sur un système d’exploitation Windows est un descendant ou un membre de cette classe.
La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées par ordre alphabétique, et non par ordre MOF.
Syntaxe
class Win32_PrintJob : CIM_Job
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
datetime ElapsedTime;
string JobStatus;
string Notify;
string Owner;
uint32 Priority;
datetime StartTime;
datetime TimeSubmitted;
datetime UntilTime;
string Color;
string DataType;
string Document;
string DriverName;
string HostPrintQueue;
uint32 JobId;
uint32 PagesPrinted;
uint32 PaperLength;
string PaperSize;
uint32 PaperWidth;
string Parameters;
string PrintProcessor;
uint32 Size;
uint32 StatusMask;
uint32 TotalPages;
};
Membres
La classe _ PrintJob Win32 possède les types de membres suivants :
Méthodes
La classe _ PrintJob Win32 possède ces méthodes.
| Méthode | Description |
|---|---|
| Suspendre | Suspend un travail d’impression. |
| Sort | Poursuit un travail d’impression. |
Propriétés
La classe _ PrintJob Win32 possède ces propriétés.
-
Caption
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64), DisplayName (« Caption »)
Brève description textuelle de l’objet.
Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
Couleur
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chaîne qui indique si le document est imprimé en couleur ou monochrome. Certaines imprimantes couleur ont la possibilité d’imprimer à l’aide d’un vrai noir au lieu d’une combinaison jaune, cyan et magenta. True black crée généralement un texte plus sombre et plus clair pour les documents. Cette option est utile uniquement pour les imprimantes couleur qui prennent en charge l’impression noir.
Les valeurs sont :
-
Colorimétrique
-
Monochrome
-
-
DataType
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Format des données pour ce travail d’impression. cela indique au pilote d’imprimante de convertir les données (texte générique, PostScript ou PCL) avant l’impression, ou d’imprimer dans un format brut (pour les graphiques et les images).
Exemple : « texte »
-
-
Description
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName ("Description")
Description textuelle de l’objet.
Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
Document
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom du travail d’impression. L’utilisateur voit ce nom lors de l’affichage des documents en attente d’impression.
exemple : « Microsoft Word-Review.doc »
-
-
DriverName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom du pilote d’imprimante utilisé pour le travail d’impression.
-
-
ElapsedTime
-
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Durée d’exécution du travail.
Cette propriété est héritée de la _ tâche CIM.
-
-
HostPrintQueue
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom de l’ordinateur sur lequel le travail d’impression est créé.
-
-
InstallDate
-
-
Type de données : DateTime
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings ("MIF. DMTF | ComponentID | 001,5 "), DisplayName (" date d’installation ")
Indique le moment où l’objet a été installé. L’absence de valeur n’indique pas que l’objet n’est pas installé.
Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
JobId
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Numéro d’identification du travail. Il est utilisé par d’autres méthodes en tant que handle d’un travail mis en attente sur l’imprimante.
-
-
JobStatus
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chaîne de forme libre qui représente l’état du travail.
Cette propriété est héritée de la _ tâche CIM.
-
-
Nom
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName ("Name")
Étiquette par laquelle l’objet est connu. Lorsqu’elle est sous-classée, cette propriété peut être substituée pour être une propriété de clé.
Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
Notifier
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
L’utilisateur est averti en cas d’achèvement ou d’échec de la tâche.
Cette propriété est héritée de la _ tâche CIM.
-
-
Propriétaire
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Utilisateur qui a envoyé le travail.
Cette propriété est héritée de la _ tâche CIM.
-
-
PagesPrinted
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Nombre de pages imprimées. Cette valeur peut être 0 (zéro) si le travail d’impression ne contient pas d’informations de délimitation de page.
-
-
PaperLength
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
-
Qualificateurs : Units (dixièmes de millimètre).
Longueur du papier.
Exemple : 2794
-
-
PaperSize
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Taille du papier utilisé pour imprimer le travail. La valeur est l’une des tailles de papier possibles pour l’imprimante spécifiée dans la propriété PaperSizesSupported de la classe Win32 _ Printer .
-
-
PaperWidth
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
-
Qualificateurs : Units (dixièmes de millimètre).
Largeur du papier.
Exemple : 2159
-
-
Paramètres
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Paramètres facultatifs à envoyer au processeur d’impression. Pour plus d’informations, consultez la propriété PrintProcessor .
-
-
PrintProcessor
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Service du processeur d’impression utilisé pour traiter le travail d’impression. Un processeur d’imprimante fonctionne conjointement avec le pilote d’imprimante pour fournir une traduction supplémentaire des données de l’imprimante pour l’imprimante et peut également être utilisé pour fournir des options spéciales, telles qu’une page de titre pour le travail.
-
-
Priorité
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Importance de l’exécution d’un travail.
Cette propriété est héritée de la _ tâche CIM.
-
-
Taille
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (octets)
Taille du travail d’impression.
-
-
StartTime
-
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Heure de début de la tâche.
Cette propriété est héritée de la _ tâche CIM.
-
-
État
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (10), DisplayName ("Status")
Chaîne qui indique l’état actuel de l’objet. L’état opérationnel et non opérationnel peut être défini. L’état opérationnel peut inclure « OK », « détérioré » et « échec prédit ». « Échec prédit » indique qu’un élément fonctionne correctement, mais prédit un échec (par exemple, un lecteur de disque dur intelligent).
L’état non opérationnel peut inclure « erreur », « démarrage », « arrêt » et « service ». Le « service » peut s’appliquer pendant la mise en miroir de disques, en rechargeant une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous les travaux de ce type ne sont pas en ligne, mais l’élément géré n’est ni « OK », ni l’un des autres États.
Cette propriété est héritée de CIM _ ManagedSystemElement.
Les valeurs sont notamment les suivantes :
-
-
OK (« OK »)
-
Erreur (« erreur »)
-
Détérioré (« détérioré »)
-
Inconnu ("inconnu")
-
Échec prévu (« échec prédit »)
-
Démarrage en cours (« démarrage »)
-
Arrêt en cours (« arrêt »)
-
Service (« service »)
-
Stressed (« stressed »)
-
Non récupéré (« non récupéré »)
-
Aucun contact (« aucun contact »)
-
Communication perdue (« inversée comm »)
StatusMask
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Bitmap des États possibles liés à ce travail d’impression.
1 (0x1)
Suspendu
2 (0X2)
Erreur
4 (0x4)
Suppression
8 (0x8)
Attente
16 (0x10)
Impression
32 (0x20)
Hors connexion
64 (0x40)
Paperout
128 (0x80)
Affiche
256 (0x100)
Deleted
512 (0x200)
_DevQ bloqué
1024 (0x400)
_Demande d’intervention de l’utilisateur _
2048 (0x800)
Redémarrer
TimeSubmitted
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Heure à laquelle le travail a été soumis.
Cette propriété est héritée de la _ tâche CIM.
TotalPages
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Nombre de pages nécessaires pour terminer le travail. Cette valeur peut être 0 (zéro) si le travail d’impression ne contient pas d’informations de délimitation de page.
UntilTime
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Heure à laquelle le travail n’est pas valide ou doit être arrêté.
Cette propriété est héritée de la _ tâche CIM.
Notes
La classe _ PrintJob Win32 est dérivée de la _ tâche CIM.
Exemples
L’exemple de code VBScript suivant décrit comment récupérer des statistiques de travaux d’impression à partir d’instances de Win32 _ PrintJob.
Set PrintJobSet = GetObject("winmgmts:").InstancesOf ("Win32_PrintJob")
If (PrintJobSet.Count = 0) Then WScript.Echo "No print jobs!"
for each PrintJob in PrintJobSet
WScript.Echo PrintJob.Name
WScript.Echo PrintJob.JobId
WScript.Echo PrintJob.Status
WScript.Echo PrintJob.TotalPages
Wscript.Echo ""
next
L’exemple de code perl suivant décrit comment récupérer des statistiques de travaux d’impression à partir d’instances de Win32 _ PrintJob.
use strict;
use Win32::OLE;
close (STDERR);
my ($PrintJobset, $PrintJob);
eval {$PrintJobset = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}")->
InstancesOf ("Win32_PrintJob") };
if (!$@ && defined $PrintJobset)
{
if ($PrintJobset->{Count} == 0 )
{
print "\nNo print jobs!\n";
}
foreach $PrintJob (in $PrintJobset)
{
print $PrintJob->{Name} , "\n";
print $PrintJob->{JobId} , "\n";
print $PrintJob->{Status} , "\n";
print $PrintJob->{TotalPages} , "\n";
}
}
else
{
print Win32::OLE->LastError, "\n";
}
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
\Cimv2 racine |
| MOF |
|
| DLL |
|