Partager via


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