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

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

Vedi anche

GdiDeleteSpoolFileHandle