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_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[데스크톱 앱만] |
헤더 |
|