Funzione GdiGetSpoolFileHandle (winppi.h)

  • Articolo

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 seguenti.

pDevmode

Puntatore fornito dal chiamante a una struttura DEVMODEW . Vedere la sezione Osservazioni seguenti.

pwszDocName

Puntatore fornito dal chiamante al nome del documento del processo di stampa. Vedere la sezione Osservazioni seguenti.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce un handle di file spool. In caso contrario, la funzione restituisce NULL.

Commenti

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 Argomento
pwszPrinterName Puntatore al nome della stampante ricevuto dalla funzione OpenPrintProcessor del processore di stampa.
pDevmode Puntatore alla struttura DEVMODEW contenuta nella struttura PRINTPROCESSOROPENDATA , ricevuta 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 del dispositivo per il disegno. Il processore di stampa può ottenere l'handle del contesto del dispositivo chiamando GdiGetDC.

Per altre informazioni, vedere Uso di funzioni GDI nei processori di stampa.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione winppi.h (include Winppi.h)
Libreria Gdi32.Lib
DLL Gdi32.dll

Vedi anche

GdiDeleteSpoolFileHandle