_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
Win32 _ Printer. mof
DLL
CIMWin32.dll

Voir aussi

_Travail CIM

Classes matérielles du système informatique