EndPagePrinter, functie

Met de functie EndPagePrinter wordt de afdrukspooler aangegeven dat de toepassing zich aan het einde van een pagina in een afdruktaak bevindt.

Syntaxis

BOOL EndPagePrinter(
  _In_ HANDLE hPrinter
);

Parameterwaarden

hPrinter [in]

Greep aan de printer waarvoor de pagina wordt afgesloten. Gebruik de functie OpenPrinter of AddPrinter om een printergreep op te halen.

Retourwaarde

Als de functie slaagt, is de retourwaarde een niet-nulwaarde.

Als de functie mislukt, is de retourwaarde nul.

Opmerkingen

Opmerking

Dit is een blokkerende of synchrone functie en retourneert mogelijk niet onmiddellijk. Hoe snel deze functie retourneert, is afhankelijk van runtimefactoren zoals netwerkstatus, configuratie van afdrukserver en implementatiefactoren van printerstuurprogramma's die moeilijk te voorspellen zijn bij het schrijven van een toepassing. Als u deze functie aanroept vanuit een thread die interactie met de gebruikersinterface beheert, kan de toepassing niet reageren.

De volgorde voor een afdruktaak is als volgt:

1. Als u een afdruktaak wilt starten, roept u StartDocPrinter aan.
2. Als u elke pagina wilt starten, roept u StartPagePrinter aan.
3. Als u gegevens naar een pagina wilt schrijven, roept u WritePrinter aan.
4. Als u elke pagina wilt beëindigen, roept u EndPagePrinter aan.
5. Herhaal 2, 3 en 4 voor zoveel pagina's als nodig is.
6. Als u de afdruktaak wilt beëindigen, roept u EndDocPrinter aan.

Wanneer een pagina in een gepoold bestand ongeveer 350 MB overschrijdt, kan het niet worden afgedrukt en wordt er geen foutbericht verzonden. Dit kan bijvoorbeeld gebeuren bij het afdrukken van grote EMF-bestanden. De limiet voor de paginagrootte is afhankelijk van veel factoren, waaronder de hoeveelheid beschikbaar virtueel geheugen, de hoeveelheid geheugen die is toegewezen door aanroepende processen en de hoeveelheid fragmentatie in de proces-heap.

Behoeften

Voorwaarde	Waarde
Minimaal ondersteunde client	Windows 2000 Professional [alleen desktop-apps]
Minimaal ondersteunde server	Windows 2000 Server [alleen desktop-apps]
Koptekst	Winspool.h (inclusief Windows.h)
Bibliotheek	Winspool.lib
DLL	Spoolss.dll

Zie ook

Afdrukken

Spooler-API-functies afdrukken

EndDocPrinter

OpenPrinter

StartDocPrinter

StartPagePrinter

WritePrinter