CDC::AbortDoc
Beendet den aktuellen Druckauftrag und löscht alle, welches, die Anwendung auf dem Gerät seit dem letzten Aufruf der - Memberfunktion StartDoc geschrieben hat.
int AbortDoc( );
Rückgabewert
Ein Wert größer oder gleich 0, wenn erfolgreich oder ein negativer Wert, wenn ein Fehler aufgetreten ist. Die folgende Liste enthält allgemeine Fehlerwerte und ihre Bedeutung an:
SP_ERROR Generalfehler.
SP_OUTOFDISK nicht genügend Speicherplatz ist zum Spoolen verfügbar, und nicht mehr Speicherplatz wird verfügbar.
SP_OUTOFMEMORY nicht genügend Arbeitsspeicher ist zum Spoolen verfügbar.
SP_USERABORT Benutzer beendet den Auftrag durch den Druck - Manager.
Hinweise
Diese Memberfunktion ersetzt das ABORTDOC Druckerescape.
AbortDoc sollte verwendet werden, um Folgendes zu beenden:
Drucksvorgänge, die eine Abbruchfunktion nicht mit SetAbortProc angeben.
Drucksvorgänge, die noch nicht der erste NEWFRAME oder NEXTBAND Escapeaufruf erreicht haben.
Wenn eine Anwendung einen Drucksfehler oder einen abgebrochenen Druckvorgang trifft, darf es nicht versuchen, den Vorgang zu beenden, indem Sie entweder die EndDoc oder AbortDoc-Memberfunktionen der Klasse CDC verwenden. GDI beendet automatisch den Vorgang, bevor der Fehlerwert zurückgibt.
Wenn die Anwendung ein Dialogfeld angezeigt, um dem Benutzer zu ermöglichen, den Druckvorgang abzubrechen, muss sie AbortDoc aufrufen, bevor das Dialogfeld zerstören.
Wenn Drucken - Manager verwendet wurde, um den Druckauftrag, AbortDoc dazu zu starten löscht den gesamten Spoolauftrag - der Drucker empfängt nichts. Wenn Drucken - Manager nicht verwendet wurde, um den Druckauftrag zu starten, gesendet wurde möglicherweise die Daten an den Drucker, bevor AbortDoc aufgerufen wurde. In diesem Fall wird der Druckertreiber den Drucker (sofern möglich) zurückgesetzt haben und dem Druckauftrag geschlossen.
Beispiel
Im Beispiel für CDC::StartDoc.
Anforderungen
Header: afxwin.h