ScheduleJob 함수

ScheduleJob 함수는 인쇄 스풀러가 인쇄를 위해 지정된 인쇄 작업을 예약할 것을 요청합니다.

구문

BOOL ScheduleJob(
  _In_ HANDLE hPrinter,
  _In_ DWORD  dwJobID
);

매개 변수

hPrinter [in]

인쇄 작업을 위한 프린터 핸들입니다. 스풀 프린터로 구성된 로컬 프린터여야 합니다. hPrinter가 원격 프린터 연결에 대한 핸들이거나 프린터가 직접 인쇄를 위해 구성된 경우 ScheduleJob 함수가 실패합니다. OpenPrinter 또는 AddPrinter 함수를 사용하여 프린터 핸들을 검색합니다.

hPrinter는 dwJobID 인쇄 작업 식별자를 가져온 AddJob 호출에 지정된 프린터 핸들과 동일해야 합니다.

dwJobID [in]

예약할 인쇄 작업입니다. AddJob 함수를 호출하여 이 인쇄 작업 식별자를 가져옵니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다.

설명

참고

이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 얼마나 빨리 반환되는지는 네트워크 상태, 인쇄 서버 구성 및 애플리케이션을 작성할 때 예측하기 어려운 프린터 드라이버 구현 요소와 같은 런타임 요인에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.

ScheduleJob 함수를 호출하기 전에 AddJob 함수를 성공적으로 호출해야 합니다. AddJob 은 ScheduleJob 에 dwJobID로 전달하는 인쇄 작업 식별자를 가져옵니다. 두 호출 모두 hPrinter에 대해 동일한 값을 사용해야 합니다.

ScheduleJob 함수는 유효한 스풀 파일을 확인합니다. 잘못된 스풀 파일이 있거나 비어 있는 경우 ScheduleJob 은 인쇄 스풀러에서 스풀 파일과 해당 인쇄 작업 항목을 모두 삭제합니다.

요구 사항

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

추가 정보

인쇄

인쇄 스풀러 API 함수

AddJob

OpenPrinter