PRINTER_NOTIFY_INFO_DATA 구조체

  • 아티클

PRINTER_NOTIFY_INFO_DATA 구조체는 작업 또는 프린터 정보 필드를 식별하고 해당 필드에 대한 현재 데이터를 제공합니다.

FindNextPrinterChangeNotification 함수는 PRINTER_NOTIFY_INFO_DATA 구조체의 배열을 포함하는 PRINTER_NOTIFY_INFO 구조를 반환합니다.

구문

typedef struct _PRINTER_NOTIFY_INFO_DATA {
  WORD  Type;
  WORD  Field;
  DWORD Reserved;
  DWORD Id;
  union {
    DWORD  adwData[2];
    struct {
      DWORD  cbBuf;
      LPVOID pBuf;
    } Data;
  } NotifyData;
} PRINTER_NOTIFY_INFO_DATA, *PPRINTER_NOTIFY_INFO_DATA; ;

멤버

형식

제공된 정보의 유형을 나타냅니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
JOB_NOTIFY_TYPE
0x01
 Field 멤버가 JOB_NOTIFY_FIELD_* 상수를 지정했음을 나타냅니다.
PRINTER_NOTIFY_TYPE
0x00
 Field 멤버가 PRINTER_NOTIFY_FIELD_* 상수를 지정했음을 나타냅니다.

필드

변경된 필드를 나타냅니다. 가능한 값 목록은 주의 섹션을 참조하세요.

Reserved

예약되어 있습니다.

ID

Type 멤버가 JOB_NOTIFY_TYPE 지정하는 경우 작업 식별자를 나타냅니다. Type 멤버가 PRINTER_NOTIFY_TYPE 지정하면 이 멤버는 정의되지 않습니다.

NotifyData

형식 및 필드 멤버를 기반으로 하는 데이터 정보의 통합입니다. 각 필드와 연결된 데이터 형식에 대한 설명은 주의 섹션을 참조하세요.

adwData[2]

두 DWORD 값의 배열입니다. 단일 DWORD만 사용하는 정보 필드의 경우 데이터는 adwData [0]에 있습니다.

Data

cbBuf

pBuf가 가리키는 버퍼의 크기(바이트)를 나타냅니다.

pBuf

필드의 현재 데이터를 포함하는 버퍼에 대한 포인터입니다.

설명

Type 멤버가 PRINTER_NOTIFY_TYPE 지정하는 경우 Field 멤버는 다음 값 중 하나일 수 있습니다.

필드 데이터 형식 값
PRINTER_NOTIFY_FIELD_SERVER_NAME 지원되지 않습니다. 0x00
PRINTER_NOTIFY_FIELD_PRINTER_NAME pBuf 는 프린터 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 0x01
PRINTER_NOTIFY_FIELD_SHARE_NAME pBuf 는 프린터의 공유 지점을 식별하는 null로 끝나는 문자열에 대한 포인터입니다. 0x02
PRINTER_NOTIFY_FIELD_PORT_NAME pBuf 는 인쇄 작업이 인쇄될 포트의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. "프린터 풀링"을 선택하면 쉼표로 구분된 포트 목록입니다. 0x03
PRINTER_NOTIFY_FIELD_DRIVER_NAME pBuf 는 프린터 드라이버의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 0x04
PRINTER_NOTIFY_FIELD_COMMENT pBuf 는 일반적으로 프린터에 대한 간단한 설명인 새 주석 문자열을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 0x05
PRINTER_NOTIFY_FIELD_LOCATION pBuf 는 프린터의 새 물리적 위치(예: "Bldg. 38, Room 1164")를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 0x06
PRINTER_NOTIFY_FIELD_DEVMODE pBuf 는 용지 방향 및 해상도와 같은 기본 프린터 데이터를 정의하는 DEVMODE 구조체에 대한 포인터입니다. 0x07
PRINTER_NOTIFY_FIELD_SEPFILE pBuf 는 구분 기호 페이지를 만드는 데 사용되는 파일의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 페이지는 프린터로 전송된 인쇄 작업을 구분하는 데 사용됩니다. 0x08
PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR pBuf 는 프린터에서 사용하는 인쇄 프로세서의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x09
PRINTER_NOTIFY_FIELD_PARAMETERS pBuf 는 기본 인쇄 프로세서 매개 변수를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x0A
PRINTER_NOTIFY_FIELD_DATATYPE pBuf 는 인쇄 작업을 기록하는 데 사용되는 데이터 형식을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x0B
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR pBuf 는 프린터의 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. 보안 설명자가 없는 경우 포인터는 NULL 일 수 있습니다. 0x0C
PRINTER_NOTIFY_FIELD_ATTRIBUTES adwData [0]은 다음 값 중 하나일 수 있는 프린터 특성을 지정합니다.
PRINTER_ATTRIBUTE_QUEUED
PRINTER_ATTRIBUTE_DIRECT
PRINTER_ATTRIBUTE_DEFAULT
PRINTER_ATTRIBUTE_SHARED
 0x0D
PRINTER_NOTIFY_FIELD_PRIORITY adwData [0]은 스풀러가 인쇄 작업을 라우팅하는 데 사용하는 우선 순위 값을 지정합니다. 0x0E
PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY adwData [0]은 각 인쇄 작업에 할당된 기본 우선 순위 값을 지정합니다. 0x0F
PRINTER_NOTIFY_FIELD_START_TIME adwData [0]은 프린터가 작업을 인쇄할 가장 이른 시간을 지정합니다. 이 값은 오전 12시 이후 경과된 시간(분)으로 지정됩니다. 0x10
PRINTER_NOTIFY_FIELD_UNTIL_TIME adwData [0]은 프린터가 작업을 인쇄할 최신 시간을 지정합니다. 이 값은 오전 12시 이후 경과된 시간(분)으로 지정됩니다. 0x11
PRINTER_NOTIFY_FIELD_STATUS adwData [0]은 프린터 상태 지정합니다. 가능한 값 목록은 PRINTER_INFO_2 구조를 참조하세요. 0x12
PRINTER_NOTIFY_FIELD_STATUS_STRING 지원되지 않습니다. 0x13
PRINTER_NOTIFY_FIELD_CJOBS adwData [0]은 프린터에 대해 큐에 대기된 인쇄 작업 수를 지정합니다. 0x14
PRINTER_NOTIFY_FIELD_AVERAGE_PPM adwData [0]은 프린터에 인쇄된 분당 평균 페이지 수를 지정합니다. 0x15
PRINTER_NOTIFY_FIELD_TOTAL_PAGES 지원되지 않습니다. 0x16
PRINTER_NOTIFY_FIELD_PAGES_PRINTED 지원되지 않습니다. 0x17
PRINTER_NOTIFY_FIELD_TOTAL_BYTES 지원되지 않습니다. 0x18
PRINTER_NOTIFY_FIELD_BYTES_PRINTED 지원되지 않습니다. 0x19
PRINTER_NOTIFY_FIELD_OBJECT_GUID 개체 GUID가 변경되면 설정됩니다. 0x1A
PRINTER_NOTIFY_FIELD_FRIENDLY_NAME 프린터 연결의 이름이 바뀌면 설정됩니다. 0x1B

Type 멤버가 JOB_NOTIFY_TYPE 지정하는 경우 Field 멤버는 다음 값 중 하나일 수 있습니다.

필드 데이터 형식 값
JOB_NOTIFY_FIELD_PRINTER_NAME pBuf 는 작업이 스풀링되는 프린터의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 0x00
JOB_NOTIFY_FIELD_MACHINE_NAME pBuf 는 인쇄 작업을 만든 컴퓨터의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x01
JOB_NOTIFY_FIELD_PORT_NAME pBuf 는 프린터로 데이터를 전송하는 데 사용되는 포트를 식별하는 null로 끝나는 문자열에 대한 포인터입니다. 프린터가 둘 이상의 포트에 연결된 경우 포트 이름은 쉼표로 구분됩니다(예: "LPT1:,LPT2:,LPT3:"). 0x02
JOB_NOTIFY_FIELD_USER_NAME pBuf 는 인쇄 작업을 보낸 사용자의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x03
JOB_NOTIFY_FIELD_NOTIFY_NAME pBuf 는 작업을 인쇄할 때 또는 작업을 인쇄하는 동안 오류가 발생할 때 알림을 받아야 하는 사용자의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x04
JOB_NOTIFY_FIELD_DATATYPE pBuf 는 인쇄 작업을 기록하는 데 사용되는 데이터 형식을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x05
JOB_NOTIFY_FIELD_PRINT_PROCESSOR pBuf 는 작업을 인쇄하는 데 사용할 인쇄 프로세서의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x06
JOB_NOTIFY_FIELD_PARAMETERS pBuf 는 인쇄 프로세서 매개 변수를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x07
JOB_NOTIFY_FIELD_DRIVER_NAME pBuf 는 인쇄 작업을 처리하는 데 사용해야 하는 프린터 드라이버의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x08
JOB_NOTIFY_FIELD_DEVMODE pBuf 는 프린터 드라이버에 대한 디바이스 초기화 및 환경 데이터를 포함하는 DEVMODE 구조체에 대한 포인터입니다. 0x09
JOB_NOTIFY_FIELD_STATUS adwData [0]은 작업 상태 지정합니다. 가능한 값 목록은 JOB_INFO_2 구조를 참조하세요. 0x0A
JOB_NOTIFY_FIELD_STATUS_STRING pBuf는 인쇄 작업의 상태 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x0B
JOB_NOTIFY_FIELD_SECURITY_DESCRIPTOR 지원되지 않습니다. 0x0C
JOB_NOTIFY_FIELD_DOCUMENT pBuf 는 인쇄 작업의 이름(예: "MS-WORD: Review.doc")을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 0x0D
JOB_NOTIFY_FIELD_PRIORITY adwData [0]은 작업 우선 순위를 지정합니다. 0x0E
JOB_NOTIFY_FIELD_POSITION adwData [0]은 인쇄 큐에서 작업의 위치를 지정합니다. 0x0F
JOB_NOTIFY_FIELD_SUBMITTED pBuf 는 작업이 제출된 시간을 지정하는 SYSTEMTIME 구조체에 대한 포인터입니다. 0x10
JOB_NOTIFY_FIELD_START_TIME adwData [0]은 작업을 인쇄할 수 있는 가장 빠른 시간을 지정합니다. 이 값은 오전 12시 이후 경과된 시간(분)으로 지정됩니다. 0x11
JOB_NOTIFY_FIELD_UNTIL_TIME adwData [0]은 작업을 인쇄할 수 있는 최신 시간을 지정합니다. 이 값은 오전 12시 이후 경과된 시간(분)으로 지정됩니다. 0x12
JOB_NOTIFY_FIELD_TIME adwData [0]은 작업이 인쇄를 시작한 이후 경과된 총 시간(초)을 지정합니다. 0x13
JOB_NOTIFY_FIELD_TOTAL_PAGES adwData [0]은 작업의 크기(페이지)를 지정합니다. 0x14
JOB_NOTIFY_FIELD_PAGES_PRINTED adwData [0]은 인쇄된 페이지 수를 지정합니다. 0x15
JOB_NOTIFY_FIELD_TOTAL_BYTES adwData [0]은 작업의 크기(바이트)를 지정합니다. 0x16
JOB_NOTIFY_FIELD_BYTES_PRINTED adwData [0]은 이 작업에 인쇄된 바이트 수를 지정합니다. 이 필드의 경우 바이트를 프린터로 보낼 때 변경 알림 개체에 신호를 보냅니다. 0x17

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
 Windows 2000 Server[데스크톱 앱만]
헤더
Winspool.h(Windows.h 포함)

추가 정보

인쇄

스풀러 API 구조 인쇄

Devmode

FindNextPrinterChangeNotification

JOB_INFO_2

PRINTER_INFO_2

PRINTER_NOTIFY_INFO

SECURITY_DESCRIPTOR

Systemtime