Funzione OpenPrintProcessor (winsplp.h)
La funzione OpenPrintProcessor di un processore di stampa prepara il processore di stampa per la stampa di un processo e restituisce un handle.
Sintassi
HANDLE OpenPrintProcessor(
[in] LPWSTR pPrinterName,
[in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);
Parametri
[in] pPrinterName
Puntatore fornito dal chiamante al nome della stampante per cui viene aperto il processore di stampa.
[in] pPrintProcessorOpenData
Puntatore fornito dal chiamante a una struttura PRINTPROCESSOROPENDATA.
Valore restituito
Se l'operazione ha esito positivo, la funzione deve restituire un handle che può essere usato come argomento di input per le chiamate successive a PrintDocumentOnPrintProcessor, ControlPrintProcessore ClosePrintProcessor. Se l'operazione non riesce, la funzione deve chiamare SetLastError per impostare un codice di errore e quindi restituire NULL.
Osservazioni
I processori di stampa sono necessari per esportare una funzione OpenPrintProcessor. Lo spooler chiama la funzione quando è disponibile un processo di stampa. La funzione deve eseguire operazioni di inizializzazione necessarie prima che un processo possa essere elaborato, in base al tipo di dati del processo.
La funzione deve restituire un handle. In genere, l'handle è un puntatore a una struttura interna. La struttura deve contenere un puntatore al nome della stampante e un puntatore alla struttura DEVMODEW della stampante, entrambi ricevuti nella struttura PRINTPROCESSOROPENDATA. Questi due puntatori sono richiesti dal processore di stampa funzione PrintDocumentOnPrintProcessor e questa seconda funzione riceve l'handle come input quando lo spooler lo chiama.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | winsplp.h (includere Winsplp.h) |
| libreria | Nwprint.lib |