Win32 _ PrintJob 类

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

以下语法从托管对象格式 (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

数据类型: 字符串

访问类型:只读

限定符: MaxLen (64) , DisplayName ( "Caption" )

对象的简短文本说明。

此属性是从 CIM _ ManagedSystemElement继承而来的。

颜色

数据类型: 字符串

访问类型:只读

指示文档是以彩色打印还是以单色打印的字符串。 有些彩色打印机可以使用真正的黑色而不是黄色、蓝绿色和洋红色的组合来打印。 True 黑色通常为文档创建更暗且更锐利的文本。 此选项仅适用于支持真正黑色打印的彩色打印机。

有效值为:

颜色

单色

DataType

数据类型: 字符串

访问类型:只读

此打印作业的数据格式。 这会指示打印机驱动程序在打印之前将数据转换 (一般文本、PostScript 或 PCL) ,或者以原始格式 (为图形和图片) 打印数据。

示例: "TEXT"

说明

数据类型: 字符串

访问类型:只读

限定符: DisplayName ( "Description" )

对象的文本说明。

此属性是从 CIM _ ManagedSystemElement继承而来的。

Document

数据类型: 字符串

访问类型:只读

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

示例: "Microsoft Word Review.doc"

DriverName

数据类型: 字符串

访问类型:只读

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

ElapsedTime

数据类型: datetime

访问类型:只读

作业已执行的时间长度。

此属性继承自 CIM _ 作业

HostPrintQueue

数据类型: 字符串

访问类型:只读

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

InstallDate

数据类型: datetime

访问类型:只读

限定符: MappingStrings ( "MIF。DMTF | 组件 | 001.5 ") 、 DisplayName (" Install Date ")

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

此属性是从 CIM _ ManagedSystemElement继承而来的。

JobId

数据类型: uint32

访问类型:只读

作业的标识符号。 其他方法使用它作为到打印机的作业假脱机的句柄。

JobStatus

数据类型: 字符串

访问类型:只读

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

此属性继承自 CIM _ 作业

名称

数据类型: 字符串

访问类型:只读

限定符: DisplayName ( "Name" )

对象已知的标签。 当有子类时,此属性可被重写为键属性。

此属性是从 CIM _ ManagedSystemElement继承而来的。

通知

数据类型: 字符串

访问类型:只读

当作业完成或失败时,会通知用户。

此属性继承自 CIM _ 作业

所有者

数据类型 :string

访问类型:只读

提交作业的用户。

此属性继承自 CIM _ 作业

PagesPrinted

数据类型 :uint32

访问类型:只读

打印的页数。 如果打印作业不包含页分隔 (,则此值) 0 或零。

PaperLength

数据类型 :uint32

访问类型:只读

限定符 : ( 十分之几毫米.)

纸张的长度。

示例:2794

PaperSize

数据类型 :string

访问类型:只读

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

PaperWidth

数据类型 :uint32

访问类型:只读

限定符 : ( 十分之几毫米.)

纸张的宽度。

示例:2159

Parameters

数据类型 :string

访问类型:只读

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

PrintProcessor

数据类型 :string

访问类型:只读

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

Priority

数据类型 :uint32

访问类型:只读

作业执行的重要性。

此属性继承自 CIM _ 作业

大小

数据类型 :uint32

访问类型:只读

限定符: 单位 (字节)

打印作业的大小。

StartTime

数据类型 :datetime

访问类型:只读

作业的开始时间。

此属性继承自 CIM _ 作业

状态

数据类型 :string

访问类型:只读

限定符 :MaxLen (10 ) ,DisplayName ("Status")

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

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

此属性继承自 CIM _ ManagedSystemElement

包括以下值:

确定 ("确定")

错误 ("错误")

降级 (" 已降级")

未知 ("未知")

预故障 (" 预失败")

("Starting")

停止 ("正在停止")

服务 ("服务")

强调 ("压力")

NonRecover ("NonRecover")

无联系人 ("无联系人")

丢失的 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)

已阻止 _ 的 DevQ

1024 (0x400)

用户 _ 干预 _ 要求

2048 (0x800)

重启

TimeSubmitted

数据类型: datetime

访问类型:只读

提交作业的时间。

此属性继承自 CIM _ 作业

TotalPages

数据类型: uint32

访问类型:只读

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

UntilTime

数据类型: datetime

访问类型:只读

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

此属性继承自 CIM _ 作业

备注

Win32 _ PrintJob 类派生自 CIM _ 作业

示例

下面的 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
命名空间
根 \ CIMV2
MOF
Win32 _ Printer mof
DLL
CIMWin32.dll

另请参阅

CIM _ 作业

计算机系统硬件类