Win32_PrintJob clase

Artículo
06/12/2023

La Win32_PrintJobclase WMI representa un trabajo de impresión generado por una aplicación de Windows. Cualquier unidad de trabajo generada por el comando print de una aplicación que se ejecuta en un equipo que se ejecuta en un sistema operativo Windows es un descendiente o miembro de esta clase.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.

Sintaxis

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

Miembros

La clase Win32_PrintJob tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

La clase Win32_PrintJob tiene estos métodos.

Método	Descripción
Pausa	Pausa un trabajo de impresión.
Reanudar	Continúa un trabajo de impresión.

Propiedades

La clase Win32_PrintJob tiene estas propiedades.

Caption

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (64), DisplayName ("Caption")

Descripción textual breve del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Color

Tipo de datos: cadena
Tipo de acceso: solo lectura

Cadena que indica si el documento se imprime en color o monocromo. Algunas impresoras de color tienen la capacidad de imprimir utilizando negro verdadero en lugar de una combinación de amarillo, cian y magenta. True negro normalmente crea texto más oscuro y más nitidez para los documentos. Esta opción solo es útil para las impresoras de color que admiten la impresión negra verdadera.

Los valores son:

"Color"
"Monocromo"

DataType

Tipo de datos: cadena
Tipo de acceso: solo lectura

Formato de los datos de este trabajo de impresión. Esto indica al controlador de impresora que traduzca los datos (texto genérico, PostScript o PCL) antes de imprimir o imprimir en un formato sin formato (para gráficos e imágenes).

Ejemplo: "TEXT"

Descripción

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: DisplayName ("Descripción")

Descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Documento

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre del trabajo de impresión. El usuario ve este nombre al ver los documentos que están esperando imprimirse.

Ejemplo: "Microsoft Word - Review.doc"

DriverName

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre del controlador de impresora usado para el trabajo de impresión.

ElapsedTime

Tipo de datos: datetime
Tipo de acceso: solo lectura

Período de tiempo durante el que se ha ejecutado el trabajo.

Esta propiedad se hereda de CIM_Job.

HostPrintQueue

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre del equipo en el que se crea el trabajo de impresión.

InstallDate

Tipo de datos: datetime
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

JobId

Tipo de datos: uint32
Tipo de acceso: solo lectura

Número de identificador del trabajo. Otros métodos lo usan como identificador para una cola de trabajos en la impresora.

Estado del trabajo

Tipo de datos: cadena
Tipo de acceso: solo lectura

Cadena de forma libre que representa el estado del trabajo.

Esta propiedad se hereda de CIM_Job.

Nombre

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: DisplayName ("Name")

Etiqueta por la que se conoce el objeto. Cuando se subclase, esta propiedad se puede invalidar para que sea una propiedad de clave.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Notificar

Tipo de datos: cadena
Tipo de acceso: solo lectura

Se notifica al usuario tras la finalización o error del trabajo.

Esta propiedad se hereda de CIM_Job.

Propietario

Tipo de datos: cadena
Tipo de acceso: solo lectura

Usuario que envió el trabajo.

Esta propiedad se hereda de CIM_Job.

PagesPrinted

Tipo de datos: uint32
Tipo de acceso: solo lectura

Número de páginas que se imprimen. Este valor puede ser 0 (cero) si el trabajo de impresión no contiene información delimitadora de páginas.

PaperLength

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: Unidades (Décimas de un milímetro).

Longitud del papel.

Ejemplo: 2794

PaperSize

Tipo de datos: cadena
Tipo de acceso: solo lectura

Tamaño del papel usado para imprimir el trabajo. El valor es uno de los posibles tamaños de papel para la impresora especificada en la propiedad PaperSizesSupported de Win32_Printer clase.

PaperWidth

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: Unidades (Décimas de un milímetro).

Ancho del papel.

Ejemplo: 2159

Parámetros

Tipo de datos: cadena
Tipo de acceso: solo lectura

Parámetros opcionales que se van a enviar al procesador de impresión. Para obtener más información, vea la propiedad PrintProcessor .

PrintProcessor

Tipo de datos: cadena
Tipo de acceso: solo lectura

Servicio de procesador de impresión usado para procesar el trabajo de impresión. Un procesador de impresora funciona junto con el controlador de impresora para proporcionar traducción adicional de datos de impresora para la impresora, y también se puede usar para proporcionar opciones especiales, como una página de título para el trabajo.

Prioridad

Tipo de datos: uint32
Tipo de acceso: solo lectura

Importancia de la ejecución de un trabajo.

Esta propiedad se hereda de CIM_Job.

Tamaño

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: unidades (bytes)

Tamaño del trabajo de impresión.

StartTime

Tipo de datos: datetime
Tipo de acceso: solo lectura

Hora a la que comenzó el trabajo.

Esta propiedad se hereda de CIM_Job.

Estado

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (10), DisplayName ("Status")

Cadena que indica el estado actual del objeto. Se puede definir el estado operativo y no operativo. El estado operativo puede incluir "Ok", "Degradado" y "Error previo". "Error previo" indica que un elemento funciona correctamente, pero predice un error (por ejemplo, una unidad de disco duro habilitada para SMART).

El estado no operativo puede incluir "Error", "Inicio", "Detención" y "Servicio". "Servicio" se puede aplicar durante la resilveración de reflejo del disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "Correcto" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Error previo ("Error previo")

Inicio ("Inicio")

Detener ("Detener")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

StatusMask

Tipo de datos: uint32
Tipo de acceso: solo lectura

Mapa de bits de los posibles estados relacionados con este trabajo de impresión.

1 (0x1)

En pausa

2 (0x2)

Error

4 (0x4)

Eliminando

8 (0x8)

Cola

16 (0x10)

Impresión

32 (0x20)

Sin conexión

64 (0x40)

Papelout

128 (0x80)

Impreso

256 (0x100)

Deleted

512 (0x200)

Blocked_DevQ

1024 (0x400)

User_Intervention_Req

2048 (0x800)

Reiniciar

TimeSubmitted

Tipo de datos: datetime
Tipo de acceso: solo lectura

Hora en que se envió el trabajo.

Esta propiedad se hereda de CIM_Job.

TotalPages

Tipo de datos: uint32
Tipo de acceso: solo lectura

Número de páginas necesarias para completar el trabajo. Este valor puede ser 0 (cero) si el trabajo de impresión no contiene información delimitadora de páginas.

UntilTime

Tipo de datos: datetime
Tipo de acceso: solo lectura

Hora en la que el trabajo no es válido o se debe detener.

Esta propiedad se hereda de CIM_Job.

Comentarios

La clase Win32_PrintJob se deriva de CIM_Job.

Ejemplos

En el ejemplo de código de VBScript siguiente se describe cómo recuperar estadísticas de trabajos de impresora de instancias 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

En el ejemplo de código Perl siguiente se describe cómo recuperar estadísticas de trabajos de impresora de instancias 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";
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	Win32_Printer.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_Job
Clases de hardware del sistema de equipos

Compartir a través de

Win32_PrintJob clase

Sintaxis

Miembros

Métodos

Propiedades

Comentarios

Ejemplos

Requisitos

Consulte también

Comentarios

Recursos adicionales