Win32_PrintJob 类

项目
06/12/2023

Win32_PrintJobWMI 类表示由 Windows 应用程序生成的打印作业。在 Windows 操作系统上运行的计算机上运行的应用程序的 print 命令生成的任何工作单元都是此类的后代或成员。

以下语法从托管对象格式 (MOF) 代码中简化，包括所有继承的属性。属性按字母顺序列出，而不是按 MOF 顺序列出。

语法

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

成员

Win32_PrintJob 类具有以下类型的成员：

方法
属性

方法

Win32_PrintJob 类具有这些方法。

方法	说明
暂停	暂停打印作业。
继续	继续打印作业。

属性

Win32_PrintJob 类具有这些属性。

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

彩色

数据类型： string
访问类型：只读

指示以彩色还是单色打印文档的字符串。某些彩色打印机能够使用真黑色而不是黄色、青色和洋红色的组合进行打印。真正的黑色通常会为文档创建更深、更清晰的文本。此选项仅适用于支持真黑色打印的彩色打印机。

有效值为：

“Color”
“单色”

DataType

数据类型： string
访问类型：只读

此打印作业的数据的格式。这会指示打印机驱动程序在打印前 (通用文本、PostScript 或 PCL) 转换数据，或以原始格式打印图形和图片 () 。

示例：“TEXT”

描述

数据类型： string
访问类型：只读
限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

Document

数据类型： string
访问类型：只读

打印作业的名称。用户在查看等待打印的文档时会看到此名称。

示例：“Microsoft Word - Review.doc”

DriverName

数据类型： string
访问类型：只读

用于打印作业的打印机驱动程序的名称。

ElapsedTime

数据类型： datetime
访问类型：只读

作业执行的时间长度。

此属性继承自 CIM_Job。

HostPrintQueue

数据类型： string
访问类型：只读

创建打印作业的计算机的名称。

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

指示对象的安装时间。缺少值并不表示未安装对象。

此属性继承自 CIM_ManagedSystemElement。

JobId

数据类型： uint32
访问类型：只读

作业的标识符号。它被其他方法用作后台打印到打印机的作业句柄。

JobStatus

数据类型： string
访问类型：只读

表示作业状态的自由格式字符串。

此属性继承自 CIM_Job。

名称

数据类型： string
访问类型：只读
限定符： DisplayName (“Name”)

对象的已知标签。当子类化时，此属性可以重写为键属性。

此属性继承自 CIM_ManagedSystemElement。

通知

数据类型： string
访问类型：只读

作业完成或失败时，用户会收到通知。

此属性继承自 CIM_Job。

所有者

数据类型： 字符串
访问类型：只读

提交作业的用户。

此属性继承自 CIM_Job。

PagesPrinted

数据类型： uint32
访问类型：只读

打印的页数。如果打印作业不包含分页分隔信息，则此值可以为 0 (零) 。

PaperLength

数据类型： uint32
访问类型：只读
限定符：单位 (毫米的十分之一。)

纸张的长度。

示例：2794

PaperSize

数据类型： 字符串
访问类型：只读

用于打印作业的纸张大小。值是 Win32_Printer 类的 PaperSizesSupported 属性中指定的打印机的可能纸张大小之一。

PaperWidth

数据类型： uint32
访问类型：只读
限定符：单位 (毫米的十分之一。)

纸张的宽度。

示例：2159

参数

数据类型： 字符串
访问类型：只读

要发送到打印处理器的可选参数。有关详细信息，请参阅 PrintProcessor 属性。

PrintProcessor

数据类型： 字符串
访问类型：只读

用于处理打印作业的打印处理器服务。打印机处理器与打印机驱动程序结合使用，为打印机提供打印机数据的其他翻译，还可用于提供特殊选项，例如作业的标题页。

优先级

数据类型： uint32
访问类型：只读

作业执行的重要性。

此属性继承自 CIM_Job。

大小

数据类型： uint32
访问类型：只读
限定符：单位 (字节)

打印作业的大小。

StartTime

数据类型： datetime
访问类型：只读

作业开始的时间。

此属性继承自 CIM_Job。

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

指示对象的当前状态的字符串。可以定义操作状态和非操作状态。操作状态可能包括“正常”、“降级”和“预失败”。 “Pred Fail”表示某个元素正常运行，但预测故障 (例如启用 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都联机，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

starting (“Starting”)

停止 (“停止”)

服务 (“服务”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

StatusMask

数据类型： uint32
访问类型：只读

与此打印作业相关的可能状态的位图。

1 (0x1)

已暂停

2 (0x2)

错误

4 (0x4)

正在删除

8 (0x8)

假脱机

16 (0x10)

打印

32 (0x20)

Offline

64 (0x40)

Paperout

128 (0x80)

打印

256 (0x100)

Deleted

512 (0x200)

Blocked_DevQ

1024 (0x400)

User_Intervention_Req

2048 (0x800)

重启

TimeSubmitted

数据类型： datetime
访问类型：只读

提交作业的时间。

此属性继承自 CIM_Job。

TotalPages

数据类型： uint32
访问类型：只读

完成作业所需的页数。如果打印作业不包含分页分隔信息，则此值可以为 0 (零) 。

UntilTime

数据类型： datetime
访问类型：只读

作业无效或应停止的时间。

此属性继承自 CIM_Job。

备注

Win32_PrintJob 类派生自 CIM_Job。

示例

以下 VBScript 代码示例介绍如何从 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

以下 Perl 代码示例介绍如何从 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";
}

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

另请参阅

CIM_Job
计算机系统硬件类

通过

Win32_PrintJob 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

其他资源