StartPagePrinter függvény

A StartPagePrinter függvény értesíti a nyomtatásisor-kezelőt, hogy a lap a megadott nyomtatóra lesz nyomtatva.

Szemantika

BOOL StartPagePrinter(
  _In_ HANDLE hPrinter
);

Paraméterek

hPrinter [in]

Fogópont egy nyomtatóhoz. 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.

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, a lap nyomtatása sikertelen lehet, é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.

Példák

A függvényt használó mintaprogramokkal kapcsolatban lásd : Útmutató: Nyomtatás a GDI Print API használatával.

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

EndDocPrinter

EndPagePrinter

OpenPrinter

StartDocPrinter

WritePrinter