CDC::SetAbortProc
installiert die Abbruchprozedur für den Druckauftrag.
int SetAbortProc(
BOOL ( CALLBACK* lpfn )( HDC, int )
);
Parameter
- lpfn
Ein Zeiger auf die als die Abbruchprozedur Abbruchfunktion, zu installieren. Weitere Informationen über die Rückruffunktion, finden Sie unter Rückruffunktion für CDC::SetAbortProc.
Rückgabewert
Gibt das Ergebnis der SetAbortProc-Funktion an. Einige der folgenden Werte sind wahrscheinlicher als andere, alle möglich.
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
Wenn eine Anwendung, den Druckauftrag zu ermöglichen, während des Spoolens abgebrochen werden kann, muss sie die Abbruchfunktion festlegen, bevor der Druckauftrag mit der StartDoc-Memberfunktion gestartet wird. Die Ausgabe - Manager ruft die Abbruchfunktion während des Spoolens, auf, um die Anwendung zu ermöglichen, den Druckauftrag abbrechen bzw. Aus-von-DatenträgerLeerzeichen Zustände zu verarbeiten. Wenn keine Abbruchfunktion festgelegt ist, schlägt der Druckauftrag aus, wenn nicht genügend Speicherplatz zum Spoolen gibt.
Beachten Sie, dass die Funktionen von Microsoft Visual C++ die Erstellung der Rückruffunktion vereinfachen, die zu SetAbortProc übergeben wird. Die Adresse, die zur EnumObjects-Memberfunktion übergeben wird, ist ein Zeiger auf eine Funktion, die mit __declspec(dllexport) und mit der __stdcall Aufrufkonvention exportiert wird.
Sie müssen auch den Funktionsnamen in einer EXPORTS-Anweisung in der Moduldefinitionsdatei Ihrer Anwendung nicht exportieren. Sie können den EXPORT-Funktionsmodifizierer, als in stattdessen verwenden
BOOLCALLBACKEXPORT AFunction ( HDC, int);
zu den Compiler anweisen, den richtigen Exportdatensatz nach Namen ohne Aliasing für den Export auszugeben. Dies funktioniert für die meisten Anforderungen. Für einige Sonderfälle wie Exportieren einer Funktion nach Ordnungszahl oder Aliasing der Export, müssen Sie dennoch eine EXPORTS-Anweisung in einer Moduldefinitionsdatei verwenden.
Rückrufregistrierungsschnittstellen sind jetzt typsicher (Sie müssen in einen Funktionszeiger übergeben, der der Rechtart der Funktion für den bestimmten Rückruf zeigt).
Beachten Sie auch, dass alle Rückruffunktionen Microsoft Foundations-Ausnahmen Felder müssen, bevor sie in Windows zurückgeben, da Ausnahmen nicht über Rückrufgrenzen ausgelöst werden können. Weitere Informationen zu Ausnahmen, finden Sie im Artikel Ausnahmen.
Anforderungen
Header: afxwin.h