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 [데스크톱 앱만 해당] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|
| 유니코드 및 ANSI 이름 |
GetSpoolFileHandleW (유니코드) 및 GetSpoolFileHandleA (ANSI) |