GdiGetSpoolFileHandle 함수(winppi.h)

  • 아티클

GdiGetSpoolFileHandle 함수는 인쇄 작업의 EMF 파일에 대한 핸들을 반환합니다.

구문

HANDLE GdiGetSpoolFileHandle(
  LPWSTR     pwszPrinterName,
  LPDEVMODEW pDevmode,
  LPWSTR     pwszDocName
);

매개 변수

pwszPrinterName

대상 프린터의 이름을 나타내는 문자열에 대한 호출자 제공 포인터입니다. 다음 설명 섹션을 참조하세요.

pDevmode

DEVMODEW 구조체에 대한 호출자 제공 포인터입니다. 다음 설명 섹션을 참조하세요.

pwszDocName

인쇄 작업의 문서 이름에 대한 호출자 제공 포인터입니다. 다음 설명 섹션을 참조하세요.

반환 값

작업이 성공하면 함수는 스풀 파일 핸들을 반환합니다. 그렇지 않으면 함수는 NULL을 반환합니다.

설명

GdiGetSpoolFileHandle 함수는 인쇄 프로세서의 PrintDocumentOnPrintProcessor 함수 내에서 사용하기 위해 gdi32.dll 의해 내보내집니다.

인쇄 프로세서가 GdiGetSpoolFileHandle을 호출하는 경우 다음 표와 같이 인수를 제공해야 합니다.

매개 변수 인수
pwszPrinterName 인쇄 프로세서의 OpenPrintProcessor 함수에서 받은 프린터 이름에 대한 포인터입니다.
pDevmode 인쇄 프로세서의 OpenPrintProcessor 함수에서 받은 PRINTPROCESSOROPENDATA 구조체에 포함된 DEVMODEW 구조체에 대한 포인터입니다.
pwszDocName 인쇄 프로세서의 PrintDocumentOnPrintProcessor 함수에서 받은 문서 이름 포인터입니다.

반환된 핸들을 다른 함수에 전달해야 하므로 인쇄 프로세서는 다른 GDI 인쇄 함수를 호출하기 전에 GdiGetSpoolFileHandle 함수를 호출해야 합니다. 함수는 OpenPrinter를 호출하여 프린터에 대한 연결을 열고 CreateDC를 호출하여 그리기용 디바이스 컨텍스트를 만듭니다. 인쇄 프로세서는 GdiGetDC를 호출하여 디바이스 컨텍스트의 핸들을 가져올 수 있습니다.

자세한 내용은 인쇄 프로세서에서 GDI 함수 사용을 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 유니버설
헤더 winppi.h(Winppi.h 포함)
라이브러리 Gdi32.Lib
DLL Gdi32.dll

추가 정보

GdiDeleteSpoolFileHandle