CommitSpoolData 함수

CommitSpoolData 함수는 인쇄 스풀러에 지정된 양의 데이터가 지정된 스풀 파일에 기록되었으며 렌더링할 준비가 되었음을 알 수 있습니다.

구문

HANDLE CommitSpoolData(
  _In_ HANDLE hPrinter,
  _In_ HANDLE hSpoolFile,
       DWORD  cbCommit
);

매개 변수

hPrinter [in]

작업이 제출된 프린터에 대한 핸들입니다. GetSpoolFileHandle을 사용하여 hSpoolFile을 가져오는 데 사용된 것과 동일한 핸들이어야 합니다.

hSpoolFile [in]

변경되는 스풀 파일에 대한 핸들입니다. CommitSpoolData의 첫 번째 호출에서 GetSpoolFileHandle에서 반환한 것과 동일한 핸들이어야 합니다. CommitSpoolData에 대한 후속 호출은 이전 호출에서 반환된 핸들을 전달해야 합니다. 설명 부분을 참조하세요.

cbCommit

인쇄 스풀러에 커밋된 바이트 수입니다.

반환 값

함수가 성공하면 스풀 파일에 대한 핸들을 반환합니다.

함수가 실패하면 INVALID_HANDLE_VALUE 반환합니다.

설명

스풀러 인쇄 작업을 제출하는 애플리케이션은 GetSpoolFileHandle 을 호출한 다음 WriteFile을 호출하여 스풀 파일 핸들에 데이터를 직접 쓸 수 있습니다. 렌더링할 준비가 된 데이터가 파일에 포함되어 있음을 인쇄 스풀러에 알리려면 애플리케이션에서 CommitSpoolData 를 호출하고 사용 가능한 바이트 수를 제공해야 합니다.

CommitSpoolData가 여러 번 호출되는 경우 각 호출은 이전 호출에서 반환된 스풀 파일 핸들을 사용해야 합니다. 스풀 파일에 더 이상 데이터가 기록되지 않으면 CommitSpoolData에 대한 마지막 호출에서 반환된 파일 핸들에 대해 CloseSpoolFileHandle을 호출해야 합니다.

CommitSpoolData를 호출하기 전에 애플리케이션은 파일에 데이터를 작성하기 전에 파일 포인터를 해당 위치에 설정해야 합니다. 스풀러 파일에서 데이터를 렌더링하는 과정에서 인쇄 스풀러는 스풀 파일 포인터 cbCommit 바이트를 파일 포인터의 현재 값에서 이동합니다.

요구 사항

추가 정보

인쇄

인쇄 스풀러 API 함수

GetSpoolFileHandle

CloseSpoolFileHandle