Fonction GdiGetPageHandle (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 spool 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 indiqués dans le tableau suivant :

Type de page	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 retournée

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

Remarques

La fonction GdiGetPageHandle est exportée par gdi32.dll pour une utilisation 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 Page est spécifiée qui est trop grande, la fonction retourne ERROR_NO_MORE_ITEMS.

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	winppi.h (inclure Winppi.h)
Bibliothèque	Gdi32.Lib
DLL	Gdi32.dll