GdiGetPageCount, fonction (winppi.h)
La fonction GdiGetPageCount retourne le nombre de pages dans un travail d’impression.
DWORD GdiGetPageCount(
HANDLE SpoolFileHandle
);
SpoolFileHandle
Handle de fichier de pool fourni par l’appelant, obtenu par un appel précédent à GdiGetSpoolFileHandle.
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.
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.
Condition requise | Valeur |
---|---|
Plateforme cible | Universal |
En-tête | winppi.h (inclure Winppi.h) |
Bibliothèque | Gdi32.Lib |
DLL | Gdi32.dll |