ControlPrintProcessor 함수(winsplp.h)
인쇄 프로세서의 ControlPrintProcessor 함수를 사용하면 스풀러가 인쇄 작업을 제어할 수 있습니다.
구문
BOOL ControlPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] DWORD Command
);
매개 변수
[in] hPrintProcessor
호출자가 제공한 인쇄 프로세서 핸들입니다. OpenPrintProcessor에 대한 이전 호출에서 반환된 핸들입니다.
[in] Command
수행할 작업 유형을 나타내는 호출자 제공 명령입니다. 다음 명령은 유효합니다.
명령 | 정의 |
---|---|
JOB_CONTROL_CANCEL | 함수는 현재 인쇄 작업을 취소해야 합니다. |
JOB_CONTROL_PAUSE | 함수는 현재 인쇄 작업을 일시 중지해야 합니다. |
JOB_CONTROL_RESUME | 함수는 현재 인쇄 작업을 다시 시작해야 합니다. |
반환 값
작업이 성공하면 함수는 TRUE를 반환해야 합니다. 작업이 실패하면 함수는 SetLastError를 호출하여 오류 코드를 설정한 다음 FALSE를 반환해야 합니다.
설명
ControlPrintProcessor 함수를 내보내려면 인쇄 프로세서가 필요합니다. 애플리케이션이 setJob 함수를 호출할 때 스풀러는 Microsoft Windows SDK 설명서에 설명된 함수를 호출합니다.
Command에 대해 받은 값에 따라 함수는 현재 작업을 일시 중지, 다시 시작 또는 취소해야 합니다. 인쇄 프로세서의 PrintDocumentOnPrintProcessor 함수가 실행되는 동안 ControlPrintProcessor 함수를 비동기적으로 호출할 수 있습니다. 따라서 작업을 일시 중지하도록 내부적으로 정의된 이벤트 개체를 설정하고 작업을 다시 시작할 때 이벤트 개체를 다시 설정하는 등의 일종의 동기화 기술을 사용해야 합니다. ControlPrintProcessor 함수는 이벤트 개체를 설정하거나 초기화한 후 신속하게 반환할 수 있으며 PrintDocumentOnPrintProcessor는 이벤트가 적절한 상태가 될 때까지 기다릴 수 있습니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 데스크톱 |
머리글 | winsplp.h(Winsplp.h 포함) |
라이브러리 | Nwprint.lib |