ControlPrintProcessor-Funktion (winsplp.h)
Die ControlPrintProcessor--Funktion eines Druckprozessors ermöglicht es dem Spooler, einen Druckauftrag zu steuern.
Syntax
BOOL ControlPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] DWORD Command
);
Parameter
[in] hPrintProcessor
Vom Anrufer bereitgestellter Druckprozessorhandle. Dies ist das Handle, das von einem vorherigen Aufruf von OpenPrintProcessorzurückgegeben wird.
[in] Command
Der vom Aufrufer bereitgestellte Befehl gibt den auszuführenden Vorgangstyp an. Die folgenden Befehle sind gültig:
| Befehl | Definition |
|---|---|
| JOB_CONTROL_CANCEL | Die Funktion sollte den aktuellen Druckauftrag abbrechen. |
| JOB_CONTROL_PAUSE | Die Funktion sollte den aktuellen Druckauftrag anhalten. |
| JOB_CONTROL_RESUME | Die Funktion sollte den aktuellen Druckauftrag fortsetzen. |
Rückgabewert
Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE-zurückgeben. Wenn der Vorgang fehlschlägt, sollte die Funktion SetLastError aufrufen, um einen Fehlercode festzulegen, und dann FALSE-zurückgeben.
Bemerkungen
Druckprozessoren sind erforderlich, um eine ControlPrintProcessor--Funktion zu exportieren. Der Spooler ruft die Funktion auf, wenn eine Anwendung die SetJob-Funktion aufruft, die in der Microsoft Windows SDK-Dokumentation beschrieben wird.
Basierend auf dem für Commandempfangenen Wert sollte die Funktion entweder anhalten, fortsetzen oder den aktuellen Auftrag abbrechen. Die ControlPrintProcessor--Funktion kann asynchron aufgerufen werden, während die PrintDocumentOnPrintProcessor--Funktion des Druckprozessors ausgeführt wird. Daher muss eine Art Synchronisierungstechnik verwendet werden, z. B. das Festlegen eines intern definierten Ereignisobjekts, um einen Auftrag anzuhalten und das Ereignisobjekt zurückzusetzen, wenn der Auftrag fortgesetzt wird. Die ControlPrintProcessor--Funktion kann schnell zurückgegeben werden, nachdem das Ereignisobjekt festgelegt oder zurückgesetzt wurde, und PrintDocumentOnPrintProcessor kann warten, bis das Ereignis im richtigen Zustand ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | winsplp.h (include Winsplp.h) |
| Library | Nwprint.lib |