다음을 통해 공유

GetSpoolFileHandle 함수

  • 아티클

GetSpoolFileHandle 함수는 애플리케이션에서 현재 제출한 작업과 연결된 스풀 파일에 대한 핸들을 검색합니다.

구문

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

매개 변수

hPrinter [in]

작업이 제출된 프린터에 대한 핸들입니다. 작업을 제출하는 데 사용된 것과 동일한 핸들이어야 합니다. ( OpenPrinter 또는 AddPrinter 함수를 사용하여 프린터 핸들을 검색합니다.)

반환 값

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

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

설명

스풀 파일에 대한 핸들을 사용하면 애플리케이션이 WriteFile 에 대한 호출과 CommitSpoolData를 호출하여 스풀 파일에 쓸 수 있습니다.

애플리케이션이 마지막으로 스풀 파일에 액세스할 때까지 hPrinter에서 ClosePrinter를 호출해서는 안 됩니다. 그런 다음 CloseSpoolFileHandle 을 호출한 다음 ClosePrinter를 호출해야 합니다. 원래 hPrinter 가 닫힌 후 스풀 파일 핸들에 액세스하려는 시도는 파일 핸들 자체가 닫혀 있지 않더라도 실패합니다. ClosePrinter가 먼저 호출되면 CloseSpoolFileHandle 자체가 실패합니다.

인쇄 작업이 스풀링을 완료하기 전에 호출되면 이 함수가 실패합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]
헤더
Winspool.h(Windows.h 포함)
라이브러리
Winspool.lib
DLL
WinSpool.drv
유니코드 및 ANSI 이름
 GetSpoolFileHandleW (유니코드) 및 GetSpoolFileHandleA (ANSI)

추가 정보

인쇄

인쇄 스풀러 API 함수

OpenPrinter

AddPrinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData