classe Win32_PrintJob

Articolo
06/12/2023

La classe WMIWin32_PrintJob rappresenta un processo di stampa generato da un'applicazione Windows. Qualsiasi unità di lavoro generata dal comando di stampa di un'applicazione in esecuzione in un computer in esecuzione in un sistema operativo Windows è un discendente o membro di questa classe.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate nell'ordine alfabetico, non nell'ordine MOF.

Sintassi

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;
};

Members

La classe Win32_PrintJob include questi tipi di membri:

Metodi
Proprietà

Metodi

La classe Win32_PrintJob include questi metodi.

Metodo	Descrizione
Sospendi	Sospende un processo di stampa.
Riprendi	Continua un processo di stampa.

Proprietà

La classe Win32_PrintJob ha queste proprietà.

Didascalia

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MaxLen (64), DisplayName ("Didascalia")

Breve descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Color

Tipo di dati: stringa
Tipo di accesso: sola lettura

Stringa che indica se il documento viene stampato in colore o monocromatico. Alcune stampanti a colori hanno la capacità di stampare usando true nero anziché una combinazione di giallo, ciano e magenta. Il colore nero true crea in genere testo più scuro e più nitido per i documenti. Questa opzione è utile solo per le stampanti a colori che supportano la stampa nera vera.

I valori possibili sono:

"Colore"
"Monocromatico"

DataType

Tipo di dati: stringa
Tipo di accesso: sola lettura

Formato dei dati per questo processo di stampa. Questo indica al driver della stampante di tradurre i dati (testo generico, PostScript o PCL) prima di stampare o stampare in un formato non elaborato (per grafica e immagini).

Esempio: "TEXT"

Descrizione

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Descrizione")

Descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Documento

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome del processo di stampa. L'utente visualizza questo nome durante la visualizzazione di documenti in attesa di stampa.

Esempio: "Microsoft Word - Review.doc"

DriverName

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome del driver della stampante usato per il processo di stampa.

ElapsedTime

Tipo di dati: datetime
Tipo di accesso: sola lettura

Tempo di esecuzione del processo.

Questa proprietà viene ereditata da CIM_Job.

HostPrintQueue

Tipo di dati: stringa
Tipo di accesso: sola lettura

Nome del computer in cui viene creato il processo di stampa.

InstallDate

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("MIF). DMTF| ComponentID|001.5"), DisplayName ("Data di installazione")

Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Jobid

Tipo di dati: uint32
Tipo di accesso: sola lettura

Numero di identificatore del processo. Viene usato da altri metodi come handle per un spooling di processi nella stampante.

Stato processo

Tipo di dati: stringa
Tipo di accesso: sola lettura

Stringa di formato libero che rappresenta lo stato del processo.

Questa proprietà viene ereditata da CIM_Job.

Nome

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Name")

Etichetta in base alla quale l'oggetto è noto. Quando viene sottoclassata, questa proprietà può essere sottoposta a override per essere una proprietà chiave.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Notificare

Tipo di dati: stringa
Tipo di accesso: sola lettura

L'utente riceve una notifica al completamento o all'errore del processo.

Questa proprietà viene ereditata da CIM_Job.

Proprietario

Tipo di dati: stringa
Tipo di accesso: sola lettura

Utente che ha inviato il processo.

Questa proprietà viene ereditata da CIM_Job.

PagesPrinted

Tipo di dati: uint32
Tipo di accesso: sola lettura

Numero di pagine stampate. Questo valore può essere 0 (zero) se il processo di stampa non contiene informazioni di delimitazione di pagina.

PaperLength

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: unità (decimi di un millimetri).

Lunghezza della carta.

Esempio: 2794

Papersize

Tipo di dati: stringa
Tipo di accesso: sola lettura

Dimensioni della carta usata per stampare il processo. Il valore è uno dei possibili formati di carta per la stampante specificata nella proprietà PaperSizesSupported della classe Win32_Printer .

PaperWidth

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: unità (decimi di un millimetri).

Larghezza della carta.

Esempio: 2159

Parameters

Tipo di dati: stringa
Tipo di accesso: sola lettura

Parametri facoltativi da inviare al processore di stampa. Per altre informazioni, vedere la proprietà PrintProcessor .

Printprocessor

Tipo di dati: stringa
Tipo di accesso: sola lettura

Servizio processore di stampa usato per elaborare il processo di stampa. Un processore di stampante funziona insieme al driver della stampante per fornire una traduzione aggiuntiva dei dati della stampante per la stampante e può anche essere usato per fornire opzioni speciali, ad esempio una pagina titolo per il processo.

Priorità

Tipo di dati: uint32
Tipo di accesso: sola lettura

Importanza dell'esecuzione di un processo.

Questa proprietà viene ereditata da CIM_Job.

Dimensione

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: unità (byte)

Dimensioni del processo di stampa.

StartTime

Tipo di dati: datetime
Tipo di accesso: sola lettura

Ora in cui il processo è iniziato.

Questa proprietà viene ereditata da CIM_Job.

Status

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MaxLen (10), DisplayName ("Status")

Stringa che indica lo stato corrente dell'oggetto. È possibile definire lo stato operativo e non operativo. Lo stato operativo può includere "OK", "Degraded" e "Pred Fail". "Pred Fail" indica che un elemento funziona correttamente, ma prevede un errore (ad esempio, un disco rigido abilitato per SMART).

Lo stato non operativo può includere "Error", "Starting", "Arresta" e "Servizio". "Servizio" può essere applicato durante il mirror-resilvering del disco, ricaricando un elenco di autorizzazioni utente o altri lavori amministrativi. Non tutti questi lavori sono online, ma l'elemento gestito non è "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore")

Degradato ("degradato ")

Sconosciuto ("sconosciuto ")

Pred Fail ("Pred Fail ")

Avvio ("Avvio ")

Arresto ("Arresto")

Servizio ("Servizio ")

Sottolineato ("stressato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

Maschera di stato

Tipo di dati: uint32
Tipo di accesso: sola lettura

Bitmap degli stati possibili correlati a questo processo di stampa.

1 (0x1)

Paused

2 (0x2)

Errore

4 (0x4)

Deleting

8 (0x8)

Spooling

16 (0x10)

Stampa

32 (0x20)

Offline

64 (0x40)

Paperout

128 (0x80)

Stampato

256 (0x100)

Eliminata

512 (0x200)

Blocked_DevQ

1024 (0x400)

User_Intervention_Req

2048 (0x800)

Riavvia

TimeSubmitted

Tipo di dati: datetime
Tipo di accesso: sola lettura

Ora di invio del processo.

Questa proprietà viene ereditata da CIM_Job.

TotalPages

Tipo di dati: uint32
Tipo di accesso: sola lettura

Numero di pagine necessarie per completare il processo. Questo valore può essere 0 (zero) se il processo di stampa non contiene informazioni di delimitazione di pagina.

UntilTime

Tipo di dati: datetime
Tipo di accesso: sola lettura

Ora in cui il processo non è valido o deve essere arrestato.

Questa proprietà viene ereditata da CIM_Job.

Commenti

La classe Win32_PrintJob deriva da CIM_Job.

Esempio

L'esempio di codice VBScript seguente descrive come recuperare le statistiche dei processi della stampante da istanze di 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'esempio di codice Perl seguente descrive come recuperare le statistiche dei processi della stampante da istanze di 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";
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Radice\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

Vedi anche

CIM_Job
Classi hardware del sistema computer

Condividi tramite

classe Win32_PrintJob

Sintassi

Members

Metodi

Proprietà

Commenti

Esempio

Requisiti

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive