classe Win32_PrintJob

Artigo
06/12/2023

A classe WMIWin32_PrintJob representa um trabalho de impressão gerado por um aplicativo do Windows. Qualquer unidade de trabalho gerada pelo comando de impressão de um aplicativo em execução em um computador em execução em um sistema operacional Windows é descendente ou membro dessa classe.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

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

Membros

A classe Win32_PrintJob tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe Win32_PrintJob tem esses métodos.

Método	Descrição
Pausa	Pausa um trabalho de impressão.
Retomar	Continua um trabalho de impressão.

Propriedades

A classe Win32_PrintJob tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (64), DisplayName ("Caption")

Uma breve descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Color

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Cadeia de caracteres que indica se o documento é impresso em cores ou monocromáticos. Algumas impressoras coloridas têm a capacidade de imprimir usando preto verdadeiro em vez de uma combinação de amarelo, ciano e magenta. Preto verdadeiro geralmente cria texto mais escuro e mais nítido para documentos. Essa opção só é útil para impressoras coloridas que dão suporte à impressão preta verdadeira.

Os valores são:

"Cor"
"Monocromático"

DataType

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Formato dos dados para este trabalho de impressão. Isso instrui o driver da impressora a traduzir os dados (texto genérico, PostScript ou PCL) antes de imprimir ou imprimir em um formato bruto (para elementos gráficos e imagens).

Exemplo: "TEXT"

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Description")

Uma descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Documento

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Nome do trabalho de impressão. O usuário vê esse nome ao exibir documentos que estão aguardando para serem impressos.

Exemplo: "Microsoft Word – Review.doc"

Drivername

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Nome do driver de impressora usado para o trabalho de impressão.

ElapsedTime

Tipo de dados: datetime
Tipo de acesso: Somente leitura

Período de tempo em que o trabalho foi executado.

Essa propriedade é herdada de CIM_Job.

HostPrintQueue

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Nome do computador no qual o trabalho de impressão é criado.

InstallDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Jobid

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Número do identificador do trabalho. Ele é usado por outros métodos como um identificador para um trabalho de spool na impressora.

JobStatus

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Cadeia de caracteres de forma livre que representa o trabalho status.

Essa propriedade é herdada de CIM_Job.

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Name")

Rótulo pelo qual o objeto é conhecido. Quando subclasse, essa propriedade pode ser substituída para ser uma propriedade de chave.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Notificar

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

O usuário é notificado após a conclusão ou falha do trabalho.

Essa propriedade é herdada de CIM_Job.

Proprietário

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Usuário que enviou o trabalho.

Essa propriedade é herdada de CIM_Job.

PagesPrinted

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Número de páginas impressas. Esse valor poderá ser 0 (zero) se o trabalho de impressão não contiver informações de delimitadoras de página.

PaperLength

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: unidades (décimos de milímetro).)

Comprimento do papel.

Exemplo: 2794

Papersize

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Tamanho do papel usado para imprimir o trabalho. O valor é um dos possíveis tamanhos de papel para a impressora especificada na propriedade PaperSizesSupported da classe Win32_Printer .

PaperWidth

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: unidades (décimos de milímetro).)

Largura do papel.

Exemplo: 2159

Parâmetros

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Parâmetros opcionais a serem enviados para o processador de impressão. Para obter mais informações, consulte a propriedade PrintProcessor .

Printprocessor

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Serviço de processador de impressão usado para processar o trabalho de impressão. Um processador de impressora trabalha em conjunto com o driver da impressora para fornecer tradução adicional de dados de impressora para a impressora e também pode ser usado para fornecer opções especiais, como uma página de título para o trabalho.

Prioridade

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Importância da execução de um trabalho.

Essa propriedade é herdada de CIM_Job.

Tamanho

Tipo de dados: uint32
Tipo de acesso: Somente leitura
Qualificadores: Unidades (Bytes)

Tamanho do trabalho de impressão.

StartTime

Tipo de dados: datetime
Tipo de acesso: Somente leitura

Hora em que o trabalho começou.

Essa propriedade é herdada de CIM_Job.

Status

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (10), DisplayName ("Status")

Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. Os status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Falha de pred ("Falha de pred")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem contato ("Sem contato")

Comm Perdido ("Comm Perdido")

StatusMask

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Bitmap dos possíveis status relacionados a esse trabalho de impressão.

1 (0x1)

Em Pausa

2 (0x2)

Erro

4 (0x4)

Excluir

8 (0x8)

Spool

16 (0x10)

Imprimindo

32 (0x20)

Offline

64 (0x40)

Paperout

128 (0x80)

Impresso

256 (0x100)

Excluído

512 (0x200)

Blocked_DevQ

1024 (0x400)

User_Intervention_Req

2048 (0x800)

Reiniciar

TimeSubmitted

Tipo de dados: datetime
Tipo de acesso: Somente leitura

Hora em que o trabalho foi enviado.

Essa propriedade é herdada de CIM_Job.

Totalpages

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Número de páginas necessárias para concluir o trabalho. Esse valor poderá ser 0 (zero) se o trabalho de impressão não contiver informações de delimitação de página.

UntilTime

Tipo de dados: datetime
Tipo de acesso: Somente leitura

Hora em que o trabalho é inválido ou deve ser interrompido.

Essa propriedade é herdada de CIM_Job.

Comentários

A classe Win32_PrintJob é derivada de CIM_Job.

Exemplos

O exemplo de código VBScript a seguir descreve como recuperar estatísticas de trabalhos de impressora de instâncias 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

O exemplo de código Perl a seguir descreve como recuperar estatísticas de trabalhos de impressora de instâncias 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	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

Confira também

CIM_Job
Classes de hardware do sistema de computador

Partilhar via

classe Win32_PrintJob

Sintaxe

Membros

Métodos

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais