Funzione GdiGetSpoolFileHandle (winppi.h)
La funzione GdiGetSpoolFileHandle restituisce un handle al file EMF di un processo di stampa.
Sintassi
HANDLE GdiGetSpoolFileHandle(
LPWSTR pwszPrinterName,
LPDEVMODEW pDevmode,
LPWSTR pwszDocName
);
Parametri
pwszPrinterName
Puntatore fornito dal chiamante a una stringa che rappresenta il nome della stampante di destinazione. Vedere la sezione Osservazioni seguente.
pDevmode
Puntatore fornito dal chiamante a una strutturaDEVMODEW. Vedere la sezione Osservazioni seguente.
pwszDocName
Puntatore fornito dal chiamante al nome del documento del processo di stampa. Vedere la sezione Osservazioni seguente.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce un handle di file di spooling. In caso contrario, la funzione restituisce NULL.
Osservazioni
La funzione GdiGetSpoolFileHandle viene esportata da gdi32.dll per l'uso all'interno della funzione printDocumentOnPrintProcessor di un processore di stampa.
Quando un processore di stampa chiama GdiGetSpoolFileHandle, deve fornire argomenti come illustrato nella tabella seguente.
| Parametro | Discussione |
|---|---|
| pwszPrinterName | Puntatore al nome della stampante ricevuto dal processore di stampa funzione OpenPrintProcessor. |
| pDevmode | Puntatore alla struttura DEVMODEW contenuta nella strutturaPRINTPROCESSOROPENDATAricevuta dalla funzione OpenPrintProcessor del processore di stampa. |
| pwszDocName | Puntatore al nome del documento ricevuto dalla funzione PrintDocumentOnPrintProcessor del processore di stampa. |
Un processore di stampa deve chiamare la funzione GdiGetSpoolFileHandle prima di chiamare qualsiasi altra funzione di stampa GDI, perché l'handle restituito deve essere passato alle altre funzioni. La funzione chiama OpenPrinter per aprire una connessione alla stampante e CreateDC per creare un contesto di dispositivo per il disegno. Il processore di stampa può ottenere l'handle del contesto di dispositivo chiamando GdiGetDC.
Per altre informazioni, vedere Uso di funzioni GDI in Processori di stampa.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | winppi.h (include Winppi.h) |
| libreria | Gdi32.Lib |
| dll | Gdi32.dll |