GdiGetPageHandle 함수(winppi.h)

GdiGetPageHandle 함수는 인쇄 작업 내의 지정된 페이지에 대한 핸들을 반환합니다.

구문

HANDLE GdiGetPageHandle(
  HANDLE  SpoolFileHandle,
  DWORD   Page,
  LPDWORD pdwPageType
);

SpoolFileHandle

GdiGetSpoolFileHandle에 대한 이전 호출에서 가져온 호출자 제공 스풀 파일 핸들입니다.

Page

호출자가 제공한 페이지 번호입니다.

pdwPageType

페이지 형식을 수신하는 위치에 대한 호출자 제공 포인터입니다. 가능한 페이지 유형은 다음 표에 나와 있습니다.

페이지 유형	의미
EMF_PP_FORM	페이지가 폼이거나 워터마크가 있습니다. 현재 지원되지 않습니다.
EMF_PP_NORMAL	페이지가 일반 페이지입니다.

작업이 성공하면 함수는 TRUE를 반환합니다. 그렇지 않으면 함수가 FALSE를 반환하고 GetLastError를 호출하여 오류 코드를 가져올 수 있습니다.

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

인쇄 프로세서는 GdiPlayPageEMF 를 호출하여 페이지를 그리기 전에 페이지 핸들을 가져와야 합니다. Page 값이 너무 큰 경우 함수는 ERROR_NO_MORE_ITEMS 반환합니다.