Fonction GdiGetSpoolFileHandle (winppi.h)
La fonction GdiGetSpoolFileHandle retourne un handle au fichier EMF d’un travail d’impression.
Syntaxe
HANDLE GdiGetSpoolFileHandle(
LPWSTR pwszPrinterName,
LPDEVMODEW pDevmode,
LPWSTR pwszDocName
);
Paramètres
pwszPrinterName
Pointeur fourni par l’appelant vers une chaîne représentant le nom de l’imprimante cible. Consultez la section Remarques suivante.
pDevmode
Pointeur fourni par l’appelant vers une structure DEVMODEW . Consultez la section Remarques suivante.
pwszDocName
Pointeur fourni par l’appelant vers le nom du document du travail d’impression. Consultez la section Remarques suivante.
Valeur retournée
Si l’opération réussit, la fonction retourne un handle de fichier de pool. Sinon, la fonction retourne NULL.
Remarques
La fonction GdiGetSpoolFileHandle est exportée par gdi32.dll pour une utilisation dans la fonction PrintDocumentOnPrintProcessor d’un processeur d’impression.
Lorsqu’un processeur d’impression appelle GdiGetSpoolFileHandle, il doit fournir des arguments comme illustré dans le tableau suivant.
| Paramètre | Argument |
|---|---|
| pwszPrinterName | Pointeur vers le nom de l’imprimante reçu par la fonction OpenPrintProcessor du processeur d’impression. |
| pDevmode | Pointeur vers la structure DEVMODEW contenue dans la structure PRINTPROCESSOROPENDATA , reçue par la fonction OpenPrintProcessor du processeur d’impression. |
| pwszDocName | Pointeur de nom de document reçu par la fonction PrintDocumentOnPrintProcessor du processeur d’impression. |
Un processeur d’impression doit appeler la fonction GdiGetSpoolFileHandle avant d’appeler d’autres fonctions d’impression GDI, car le handle retourné doit être passé aux autres fonctions. La fonction appelle OpenPrinter pour ouvrir une connexion à l’imprimante et CreateDC pour créer un contexte d’appareil pour le dessin. Le processeur d’impression peut obtenir le handle du contexte de l’appareil en appelant GdiGetDC.
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 |