Share via

Funzione ControlPrintProcessor (winsplp.h)

  • Articolo

La funzione ControlPrintProcessor di un processore di stampa consente al spooler di controllare un processo di stampa.

Sintassi

BOOL ControlPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] DWORD  Command
);

Parametri

[in] hPrintProcessor

Handle del processore di stampa fornito dal chiamante. Si tratta dell'handle restituito da una chiamata precedente a OpenPrintProcessor.

[in] Command

Comando fornito dal chiamante che indica il tipo di operazione da eseguire. I comandi seguenti sono validi:

Comando Definizione
JOB_CONTROL_CANCEL La funzione deve annullare il processo di stampa corrente.
JOB_CONTROL_PAUSE La funzione deve sospendere il processo di stampa corrente.
JOB_CONTROL_RESUME La funzione deve riprendere il processo di stampa corrente.

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire TRUE. Se l'operazione non riesce, la funzione deve chiamare SetLastError per impostare un codice di errore e quindi restituire FALSE.

Commenti

I processori di stampa sono necessari per esportare una funzione ControlPrintProcessor . Lo spooler chiama la funzione quando un'applicazione chiama la funzione SetJob, descritta nella documentazione di Microsoft Windows SDK.

In base al valore ricevuto per Command, la funzione deve sospendere, riprendere o annullare il processo corrente. La funzione ControlPrintProcessor può essere chiamata in modo asincrono mentre è in esecuzione la funzione PrintDocumentOnPrintProcessor del processore di stampa. È quindi necessario usare una tecnica di sincronizzazione, ad esempio l'impostazione di un oggetto evento definito internamente per sospendere un processo e reimpostare l'oggetto evento quando il processo viene ripreso. La funzione ControlPrintProcessor può restituire rapidamente dopo l'impostazione o la reimpostazione dell'oggetto evento e PrintDocumentOnPrintProcessor può attendere che l'evento sia nello stato appropriato.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione winsplp.h (include Winsplp.h)
Libreria Nwprint.lib

Vedi anche

OpenPrintProcessor

PrintDocumentOnPrintProcessor