classe Win32_PrintJob

La classe WMIWin32_PrintJob 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 qui s’exécute sur un ordinateur s’exécutant sur un système d’exploitation Windows est descendante ou 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 dans l’ordre alphabétique, et non dans l’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 Win32_PrintJob a les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

La classe Win32_PrintJob a ces méthodes.

Méthode	Description
Suspendre	Interrompt un travail d’impression.
Reprendre	Continue un travail d’impression.

 

Propriétés

La classe Win32_PrintJob 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.

Color

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 du vrai noir au lieu d’une combinaison de jaune, de cyan et de magenta. Le noir vrai crée généralement un texte plus sombre et plus net pour les documents. Cette option n’est utile que pour les imprimantes couleur qui prennent en charge l’impression noire véritable.

Les valeurs sont :

« Couleur »

« 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 traduire 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 : « TEXT »

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.

Heure écoulée

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 CIM_Job.

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 quand l’objet a été installé. L’absence d’une 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’identificateur du travail. Il est utilisé par d’autres méthodes comme handle pour un travail de mise en file d’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 le status de travail.

Cette propriété est héritée de CIM_Job.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Name »)

Étiquette par laquelle l’objet est connu. En cas de sous-classe, cette propriété peut être remplacé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 du travail.

Cette propriété est héritée de CIM_Job.

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 CIM_Job.

PagesPrinted

Type de données : uint32

Type d'accès : Lecture seule

Nombre de pages imprimées. Cette valeur peut être égale à 0 (zéro) si le travail d’impression ne contient pas d’informations de limitation de page.

PaperLength

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : unités (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 Win32_Printer classe.

PaperWidth

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : unités (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 de 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, 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 CIM_Job.

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 à laquelle le travail a commencé.

Cette propriété est héritée de CIM_Job.

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Chaîne qui indique la status actuelle de l’objet. Les status opérationnelles et non opérationnelles peuvent être définies. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un lecteur de disque dur compatible SMART).

Les status non opérationnelles peuvent inclure « Erreur », « Démarrage », « Arrêt » et « Service ». Le « service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans 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 de la préversion (« Échec prédé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

Masque d’état

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)

En cours de suppression

8 (0x8)

Enroulement

16 (0x10)

Impression

32 (0x20)

Hors connexion

64 (0x40)

Paperout

128 (0x80)

Imprimé

256 (0x100)

Deleted

512 (0x200)

Blocked_DevQ

1024 (0x400)

User_Intervention_Req

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 CIM_Job.

TotalPages

Type de données : uint32

Type d'accès : Lecture seule

Nombre de pages requises pour terminer le travail. Cette valeur peut être égale à 0 (zéro) si le travail d’impression ne contient pas d’informations de 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 CIM_Job.

Notes

La classe Win32_PrintJob est dérivée de CIM_Job.

Exemples

L’exemple de code VBScript suivant décrit comment récupérer les statistiques des travaux d’imprimante à 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 les statistiques des travaux d’imprimante à 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	Racine\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

Voir aussi

CIM_Job

Classes matérielles du système informatique