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 :

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