GdiGetPageHandle, fonction (winppi.h)

La fonction GdiGetPageHandle retourne un handle à la page spécifiée dans un travail d’impression.

Syntaxe

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

Paramètres

SpoolFileHandle

Handle de fichier de pool fourni par l’appelant, obtenu par un appel précédent à GdiGetSpoolFileHandle.

Page

Numéro de page fourni par l’appelant.

pdwPageType

Pointeur fourni par l’appelant vers un emplacement qui reçoit le type de page. Les types de pages possibles sont affichés dans le tableau suivant :

Page Type	Signification
EMF_PP_FORM	La page est un formulaire ou a un filigrane. (Non pris en charge actuellement.)
EMF_PP_NORMAL	La page est une page normale.

Valeur de retour

Si l’opération réussit, la fonction retourne TRUE. Sinon, la fonction retourne FAUX, et un code d’erreur peut être obtenu en appelant GetLastError.

Remarques

La fonction GdiGetPageHandle est exportée par gdi32.dll à utiliser dans la fonction PrintDocumentOnPrintProcessor d’un processeur d’impression.

Les processeurs d’impression doivent obtenir un handle de page avant d’appeler GdiPlayPageEMF pour dessiner une page. Si une valeur de page est spécifiée trop grande, la fonction retourne ERROR_NO_MORE_ITEMS.

Pour plus d’informations, consultez Utilisation de fonctions GDI dans les processeurs d’impression.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	winppi.h (inclure Winppi.h)
bibliothèque	Gdi32.Lib
DLL	Gdi32.dll