Funkce StartPagePrinter

Funkce StartPagePrinter upozorní zařazování, že stránka bude vytištěna na zadané tiskárně.

Syntaxe

BOOL StartPagePrinter(
  _In_ HANDLE hPrinter
);

Parametry

hPrinter [in]

Úchyt k tiskárně. K načtení úchytu tiskárny použijte funkci OpenPrinter nebo AddPrinter .

Návratová hodnota

Pokud je funkce úspěšná, návratová hodnota je nenulová hodnota.

Pokud funkce selže, návratová hodnota je nula.

Poznámky

Poznámka:

Jedná se o blokující nebo synchronní funkci a nemusí se vrátit okamžitě. Jak rychle tato funkce vrací, závisí na faktorech doby běhu, jako je stav sítě, konfigurace tiskového serveru a faktory implementace ovladače tiskárny, které se při psaní aplikace obtížně predikují. Volání této funkce z vlákna, které spravuje interakci s uživatelským rozhraním, může znamenat, že aplikace přestane reagovat.

Posloupnost tiskové úlohy je následující:

1. Chcete-li zahájit tiskovou úlohu, zavolejte Metodu StartDocPrinter.
2. Chcete-li zahájit každou stránku, zavolejte StartPagePrinter.
3. Pokud chcete zapisovat data na stránku, zavolejte WritePrinter.
4. Chcete-li ukončit každou stránku, zavolejte EndPagePrinter.
5. Opakujte 2, 3 a 4 pro tolik stránek, kolik je potřeba.
6. Chcete-li ukončit tiskovou úlohu, zavolejte EndDocPrinter.

Pokud stránka ve zařazovaném souboru překročí přibližně 350 MB, může selhat tisk a neodesílat chybovou zprávu. K tomu může dojít například při tisku velkých souborů EMF. Omezení velikosti stránky závisí na mnoha faktorech, včetně množství dostupné virtuální paměti, množství paměti přidělené voláním procesů a množství fragmentace v haldě procesu.

Příklady

Ukázkový program, který tuto funkci používá, najdete v tématu Postupy: Tisk pomocí rozhraní API pro tisk GDI.

Požadavky

Požadavek	Hodnota
Minimální podporovaný klient	Windows 2000 Professional [jenom desktopové aplikace]
Minimální podporovaný server	Windows 2000 Server [jenom desktopové aplikace]
Záhlaví	Winspool.h (včetně Windows.h)
Knihovna	Winspool.lib
Knihovna dll	Spoolss.dll

Viz také

Tisk

funkcí rozhraní API zařazování tisku

EndDocPrinter

EndPagePrinter

Otevřít tiskárnu

StartDocPrinter

WritePrinter