EndDocPrinter függvény

Az EndDocPrinter függvény befejezi a megadott nyomtató nyomtatási feladatát.

Szemantika

BOOL EndDocPrinter(
  _In_ HANDLE hPrinter
);

Paraméterek

hPrinter [in]

Olyan nyomtató kezelése, amelyhez a nyomtatási feladatot le kell fejezni. Nyomtatófogópont lekéréséhez használja az OpenPrinter vagy az AddPrinter függvényt.

Visszaadott érték

Ha a függvény sikeres, a visszatérési érték nem érték.

Ha a függvény sikertelen, a visszatérési érték nulla.

Megjegyzések

Megjegyzés:

Ez egy blokkoló vagy szinkron függvény, és előfordulhat, hogy nem azonnal tér vissza. A függvény visszatérési ideje olyan futásidejű tényezőktől függ, mint a hálózati állapot, a nyomtatókiszolgáló konfigurációja és a nyomtatóillesztő implementálási tényezői, amelyeket nehéz előrejelezni az alkalmazások írásakor. Ha ezt a függvényt egy olyan szálról hívja meg, amely kezeli a felhasználói felülettel való interakciót, az alkalmazás nem válaszolhat.

Az EndDocPrinter függvény hibát ad vissza, ha a nyomtatási feladat nem a StartDocPrinter függvény meghívásával indult el.

A nyomtatási feladatok sorrendje a következő:

1. Nyomtatási feladat indításához hívja meg a StartDocPrintert.
2. Az egyes lapok indításához hívja meg a StartPagePrintert.
3. Ha adatokat szeretne írni egy lapra, hívja meg a WritePrintert.
4. Az egyes lapok befejezéséhez hívja meg az EndPagePrintert.
5. Ismételje meg a 2, 3 és 4 elemet a szükséges számú oldal esetében.
6. A nyomtatási feladat befejezéséhez hívja meg az EndDocPrintert.

Ha egy többsoros fájlban lévő lap mérete meghaladja a 350 MB-ot, előfordulhat, hogy nem nyomtatható ki, és nem küld hibaüzenetet. Ez például nagy EMF-fájlok nyomtatásakor fordulhat elő. Az oldalméret korlátja számos tényezőtől függ, például a rendelkezésre álló virtuális memória mennyiségétől, a hívási folyamatok által lefoglalt memória mennyiségétől és a folyamat halomtöredezettségének mennyiségétől.

Követelmények

Követelmény	Érték
Minimálisan támogatott ügyfél	Windows 2000 Professional [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows 2000 Server [csak asztali alkalmazások]
Fejléc	Winspool.h (a Windows.h-t is tartalmazza)
Könyvtár	Winspool.lib
DLL	Spoolss.dll

Lásd még

Nyomtatás

Nyomtatásisor-kezelő API Functions

EndPagePrinter

StartDocPrinter

StartLapNyomtató

WritePrinter