StartPagePrinter-Funktion
Die StartPagePrinter-Funktion benachrichtigt den Spooler, dass eine Seite auf dem angegebenen Drucker gedruckt werden soll.
Syntax
BOOL StartPagePrinter(
_In_ HANDLE hPrinter
);
Parameter
-
hPrinter [ In]
-
Handle für einen Drucker. Verwenden Sie die OpenPrinter- oder AddPrinter-Funktion, um einen Druckerhandpunkt abzurufen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich 0 (null).
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Hinweis
Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückkehrt. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren des Druckertreibers ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu kommen, dass die Anwendung nicht reagiert.
Die Sequenz für einen Druckauftrag lautet wie folgt:
- Um einen Druckauftrag zu starten, rufen Sie StartDocPrinter auf.
- Um jede Seite zu starten, rufen Sie StartPagePrinter auf.
- Um Daten auf eine Seite zu schreiben, rufen Sie WritePrinter auf.
- Um jede Seite zu beenden, rufen Sie EndPagePrinter auf.
- Wiederholen Sie 2, 3 und 4 für so viele Seiten wie erforderlich.
- Um den Druckauftrag zu beenden, rufen Sie EndDocPrinter auf.
Wenn eine Seite in einer Spooldatei ca. 350 MB überschreitet, kann sie nicht gedruckt werden und sendet keine Fehlermeldung. Dies kann beispielsweise beim Drucken großer EMF-Dateien auftreten. Die Seitengrößenbeschränkung hängt von vielen Faktoren ab, einschließlich der Menge des verfügbaren virtuellen Arbeitsspeichers, der Durch aufrufenden Prozesse zugewiesenen Arbeitsspeichermenge und der Fragmentierung im Prozesshap.
Beispiele
Ein Beispielprogramm, das diese Funktion verwendet, finden Sie unter How To: Print Using the GDI Print API (How To: Drucken mithilfe der GDI-Druck-API).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|