Udostępnij za pośrednictwem


EndDocPrinter, funkcja

Funkcja EndDocPrinter kończy zadanie drukowania dla określonej drukarki.

Składnia

BOOL EndDocPrinter(
  _In_ HANDLE hPrinter
);

Parametry

hPrinter [in]

Obsługa drukarki, dla której zadanie drukowania powinno zostać zakończone. Użyj funkcji OpenPrinter lub AddPrinter , aby pobrać uchwyt drukarki.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest wartością niezerową.

Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość to zero.

Uwagi

Uwaga / Notatka

Jest to funkcja blokująca lub synchroniczna i może nie zwracać natychmiast. Szybkość zwracania tej funkcji zależy od czynników czasu wykonywania, takich jak stan sieci, konfiguracja serwera wydruku i czynniki implementacji sterownika drukarki, które są trudne do przewidzenia podczas pisania aplikacji. Wywołanie tej funkcji z wątku, który zarządza interakcją z interfejsem użytkownika, może sprawić, że aplikacja będzie wydawała się nie odpowiadać.

Funkcja EndDocPrinter zwraca błąd, jeśli zadanie drukowania nie zostało uruchomione przez wywołanie funkcji StartDocPrinter .

Sekwencja zadania drukowania jest następująca:

  1. Aby rozpocząć zadanie drukowania, wywołaj metodę StartDocPrinter.
  2. Aby rozpocząć każdą stronę, wywołaj metodę StartPagePrinter.
  3. Aby zapisać dane na stronie, wywołaj funkcję WritePrinter.
  4. Aby zakończyć każdą stronę, wywołaj funkcję EndPagePrinter.
  5. Powtórz 2, 3 i 4 dla jak największej liczby stron w razie potrzeby.
  6. Aby zakończyć zadanie drukowania, wywołaj metodę EndDocPrinter.

Gdy strona w buforowanych plikach przekracza około 350 MB, drukowanie może się nie powieść i nie wysyła komunikatu o błędzie. Na przykład może to wystąpić podczas drukowania dużych plików EMF. Limit rozmiaru strony zależy od wielu czynników, w tym ilości dostępnej pamięci wirtualnej, ilości pamięci przydzielonej przez wywoływanie procesów i ilości fragmentacji w stercie procesu.

Wymagania

Wymaganie Wartość
Minimalny obsługiwany klient
Windows 2000 Professional [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer
Windows 2000 Server [tylko aplikacje klasyczne]
Nagłówek
Winspool.h (w tym Windows.h)
Biblioteka
Winspool.lib
DLL
Spoolss.dll

Zobacz także

drukowanie

funkcje interfejsu API buforu wydruku

EndPagePrinter

StartDocPrinter

StartPagePrinter

WritePrinter