Win32_PrintJob 클래스

아티클
06/12/2023

Win32_PrintJobWMI 클래스는 Windows 애플리케이션에서 생성된 인쇄 작업을 나타냅니다. Windows 운영 체제에서 실행되는 컴퓨터에서 실행되는 애플리케이션의 인쇄 명령으로 생성된 모든 작업 단위는 이 클래스의 하위 항목 또는 멤버입니다.

다음 구문은 MOF(Managed Object Format) 코드를 단순화한 것으로 상속된 속성이 모두 포함되어 있습니다. 속성은 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 클래스에는 이러한 메서드가 있습니다.

메서드	Description
일시 중지	인쇄 작업을 일시 중지합니다.
다시 시작	인쇄 작업을 계속합니다.

속성

Win32_PrintJob 클래스에는 이러한 속성이 있습니다.

캡션

데이터 형식: string
액세스 형식: 읽기 전용
한정자: MaxLen (64), DisplayName ("Caption")

개체에 대한 간단한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

색상

데이터 형식: 문자열
액세스 형식: 읽기 전용

문서가 색 또는 흑백으로 인쇄되는지 여부를 나타내는 문자열입니다. 일부 컬러 프린터는 노란색, 시안, 마젠타의 조합 대신 true 검정을 사용하여 인쇄할 수 있습니다. True 검정은 일반적으로 문서에 대해 더 어둡고 선명한 텍스트를 만듭니다. 이 옵션은 참 검정 인쇄를 지원하는 컬러 프린터에만 유용합니다.

값은 다음과 같습니다.

"색"
"단색"

DataType

데이터 형식: 문자열
액세스 형식: 읽기 전용

이 인쇄 작업의 데이터 형식입니다. 이렇게 하면 프린터 드라이버가 인쇄하기 전에 데이터(일반 텍스트, PostScript 또는 PCL)를 번역하거나 원시 형식(그래픽 및 그림용)으로 인쇄하도록 지시합니다.

예: "TEXT"

설명

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Description")

개체에 대한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

Document

데이터 형식: 문자열
액세스 형식: 읽기 전용

인쇄 작업의 이름입니다. 인쇄 대기 중인 문서를 볼 때 사용자에게 이 이름이 표시됩니다.

예: "Microsoft Word - Review.doc"

DriverName

데이터 형식: 문자열
액세스 형식: 읽기 전용

인쇄 작업에 사용되는 프린터 드라이버의 이름입니다.

ElapsedTime

데이터 형식: datetime
액세스 형식: 읽기 전용

작업이 실행되고 있는 시간입니다.

이 속성은 CIM_Job 상속됩니다.

HostPrintQueue

데이터 형식: 문자열
액세스 형식: 읽기 전용

인쇄 작업을 만들 컴퓨터의 이름입니다.

InstallDate

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("설치 날짜")

개체가 설치된 시기를 나타냅니다. 값이 부족해도 개체가 설치되지 않았음을 의미하지는 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

JobId

데이터 형식: uint32
액세스 형식: 읽기 전용

작업의 식별자 번호입니다. 다른 메서드에서 프린터로 스풀링하는 작업에 대한 핸들로 사용됩니다.

JobStatus

데이터 형식: 문자열
액세스 형식: 읽기 전용

작업 상태 나타내는 자유 형식 문자열입니다.

이 속성은 CIM_Job 상속됩니다.

이름

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Name")

개체가 알려진 레이블입니다. 서브클래스를 사용하면 이 속성을 키 속성으로 재정의할 수 있습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

알림

데이터 형식: 문자열
액세스 형식: 읽기 전용

작업 완료 또는 실패 시 사용자에게 알림이 표시됩니다.

이 속성은 CIM_Job 상속됩니다.

소유자

데이터 형식: 문자열
액세스 형식: 읽기 전용

작업을 제출한 사용자입니다.

이 속성은 CIM_Job 상속됩니다.

PagesPrinted

데이터 형식: uint32
액세스 형식: 읽기 전용

인쇄되는 페이지 수입니다. 인쇄 작업에 페이지 구분 정보가 포함되지 않은 경우 이 값은 0일 수 있습니다.

PaperLength

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 단위 (밀리미터의 10분의 1)

용지의 길이입니다.

예: 2794

Papersize

데이터 형식: 문자열
액세스 형식: 읽기 전용

작업을 인쇄하는 데 사용되는 용지의 크기입니다. 값은 Win32_Printer 클래스의 PaperSizesSupported 속성에 지정된 프린터의 가능한 용지 크기 중 하나입니다.

PaperWidth

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 단위 (밀리미터의 10분의 1)

용지 너비입니다.

예: 2159

매개 변수

데이터 형식: 문자열
액세스 형식: 읽기 전용

인쇄 프로세서에 보낼 선택적 매개 변수입니다. 자세한 내용은 PrintProcessor 속성을 참조하세요.

PrintProcessor

데이터 형식: 문자열
액세스 형식: 읽기 전용

인쇄 작업을 처리하는 데 사용되는 인쇄 프로세서 서비스입니다. 프린터 프로세서는 프린터 드라이버와 함께 작동하여 프린터에 대한 프린터 데이터의 추가 번역을 제공하며 작업의 제목 페이지와 같은 특수 옵션을 제공하는 데도 사용할 수 있습니다.

우선 순위

데이터 형식: uint32
액세스 형식: 읽기 전용

작업 실행의 중요도입니다.

이 속성은 CIM_Job 상속됩니다.

크기

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 단위 (바이트)

인쇄 작업의 크기입니다.

StartTime

데이터 형식: datetime
액세스 형식: 읽기 전용

작업이 시작된 시간입니다.

이 속성은 CIM_Job 상속됩니다.

상태

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MaxLen (10), DisplayName ("상태")

개체의 현재 상태 나타내는 문자열입니다. 운영 및 비운용 상태 정의할 수 있습니다. 운영 상태 "확인", "저하됨" 및 "사전 실패"를 포함할 수 있습니다. "Pred Fail"은 요소가 제대로 작동하지만 오류를 예측하고 있음을 나타냅니다(예: SMART 지원 하드 디스크 드라이브).

비작동 상태 "오류", "시작", "중지" 및 "서비스"를 포함할 수 있습니다. 디스크 미러 다시 실행, 사용자 권한 목록 다시 로드 또는 기타 관리 작업 중에 "서비스"를 적용할 수 있습니다. 이러한 모든 작업이 온라인 상태인 것은 아니지만 관리되는 요소는 "OK"도 아니고 다른 상태 중 하나도 아닙니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

여기에는 다음 값이 포함됩니다.

확인 ("확인")

오류 ("오류")

저하됨 ("성능 저하")

알 수 없음 ("알 수 없음")

Pred Fail ("Pred Fail")

시작 ("시작")

중지 ("중지")

서비스 ("서비스")

스트레스( "스트레스")

NonRecover ("NonRecover")

연락처 없음 ("연락처 없음")

Lost Comm ("Lost Comm")

StatusMask

데이터 형식: uint32
액세스 형식: 읽기 전용

이 인쇄 작업과 관련된 가능한 상태의 비트맵입니다.

1(0x1)

일시 중지됨

2(0x2)

오류

4(0x4)

삭제 중

8(0x8)

스풀링

16(0x10)

인쇄

32(0x20)

오프라인

64(0x40)

페이퍼아웃

128(0x80)

인쇄

256 (0x100)

삭제됨

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 클래스

구문

멤버

메서드

속성

설명

예제

요구 사항

추가 정보

피드백

피드백

추가 리소스