GdiGetPageCount, fonction (winppi.h)

La fonction GdiGetPageCount retourne le nombre de pages dans un travail d’impression.

Syntaxe

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

Paramètres

SpoolFileHandle

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

Valeur retournée

Si l’opération réussit, la fonction retourne le nombre de pages dans le travail d’impression actuel. Sinon, la fonction retourne zéro.

Remarques

La fonction GdiGetPageCount est exportée par gdi32.dll pour une utilisation dans la fonction PrintDocumentOnPrintProcessor d’un processeur d’impression.

La fonction GdiGetPageCount ne retourne pas tant que toutes les pages n’ont pas été en pool, même si l’administrateur du serveur d’impression a spécifié que les travaux d’impression doivent être imprimés pendant le spoulage. Par conséquent, cette fonction ne doit pas être utilisée, sauf s’il est nécessaire d’obtenir le nombre total de pages avant que le traitement du document puisse commencer, par exemple pour imprimer des pages dans l’ordre inverse.

En règle générale, une meilleure méthode pour déterminer le nombre de pages consiste à compter le nombre d’appels effectués à GdiGetPageHandle.

Pour plus d’informations sur cet ensemble de fonctions, 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