CDC::Escape

Artikel
02/26/2013

Diese Memberfunktion ist für Win32-Programmierung praktisch veraltet.

virtual int Escape(
   int nEscape,
   int nCount,
   LPCSTR lpszInData,
   LPVOID lpOutData 
);
int Escape(
   int nEscape,
   int nInputSize,
   LPCSTR lpszInputData,
   int nOutputSize,
   LPSTR lpszOutputData 
);

Parameter

nEscape
Gibt die auszuführende Escapezeichen anfunktion.

Eine vollständige Liste der Escapefunktionen, finden Sie unter Escapezeichen in Windows SDK.
nCount
Gibt die Anzahl der Bytes Daten an, die auf durch lpszInData angezeigt werden.
lpszInData
Punkte zur Eingabedatenstruktur erforderlich für dieses Escapezeichen.
lpOutData
Zeigt auf die Struktur, die, Ausgabe von diesem Escapezeichen zu empfangen wird.Der lpOutData-Parameter ist NULL, wenn keine Daten zurückgegeben werden.
nInputSize
Gibt die Anzahl der Bytes Daten an, die von dem lpszInputData-Parameter angezeigt werden.
lpszInputData
Punkte zur Eingabestruktur erforderlich für das angegebene Escapezeichen.
nOutputSize
Gibt die Anzahl der Bytes Daten an, die von dem lpszOutputData-Parameter angezeigt werden.
lpszOutputData
Zeigt auf die Struktur, die Ausgabe von diesem Escapezeichen empfängt.Dieser Parameter sollte NULL sein, wenn keine Daten zurückgegeben werden.

Rückgabewert

Ein positiver Wert wird zurückgegeben, wenn die Funktion, mit Ausnahme des QUERYESCSUPPORT Escapezeichen erfolgreich ist, für das nur Implementierung überprüft.Null wird zurückgegeben, wenn das Escapezeichen nicht implementiert wird.Ein negativer Wert wird zurückgegeben, wenn ein Fehler aufgetreten ist.Im Folgenden werden allgemeine Fehlerwerte:

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

Von den Vorlagendruckerescapen wird nur QUERYESCSUPPORT für Win32-Anwendungen unterstützt.Alle anderen Druckerescapen sind veraltet und werden nur für Kompatibilität mit 16-Bit-Anwendungen unterstützt.

Für Office-Programmierung Win32, stellt CDC jetzt sechsköpfige Funktionen, die entsprechenden Druckerescapen ablösen:

Außerdem Escapezeichen CDC::GetDeviceCaps Unterstützungs-Win32-Indizes, die ablösen, anderer Drucker.Siehe GetDeviceCaps in Windows SDK weitere Informationen.

Diese Memberfunktion kann der Zugangsmöglichkeiten eines bestimmten Geräts Anwendungen, die nicht direkt über verfügbar GDI sind.

Verwenden Sie die erste Version wenn die vordefinierten Escapewerte der - Anwendung verwenden.Verwenden Sie die zweite Version, wenn die Anwendung private Escapewerte definiert.Siehe ExtEscape in Windows SDK weitere Informationen über die zweite Version.