EndDocPrinter 函式
EndDocPrinter 函式會結束指定印表機的列印工作。
語法
BOOL EndDocPrinter(
_In_ HANDLE hPrinter
);
參數
-
hPrinter [in]
-
列印工作應該結束的印表機控制碼。 使用 OpenPrinter 或 AddPrinter 函式來擷取印表機控制碼。
傳回值
如果函式成功，則傳回值是非零值。
如果此函式失敗，則傳回值為零。
備註
注意
這是封鎖或同步函式，可能不會立即傳回。 此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器組態，以及難以在撰寫應用程式時預測的印表機驅動程式實作因素。 從管理與使用者介面互動的執行緒呼叫此函式，可能會讓應用程式看起來沒有回應。
如果列印工作未透過呼叫 StartDocPrinter 函式來啟動， EndDocPrinter 函式會傳回錯誤。
列印工作的順序如下所示：
- 若要開始列印工作，請呼叫 StartDocPrinter。
- 若要開始每個頁面，請呼叫 StartPagePrinter。
- 若要將資料寫入頁面，請呼叫 WritePrinter。
- 若要結束每個頁面，請呼叫 EndPagePrinter。
- 視需要重複 2、3 和 4。
- 若要結束列印工作，請呼叫 EndDocPrinter。
當多工緩衝處理檔案中的頁面超過大約 350 MB 時，它可能無法列印，而不會傳送錯誤訊息。 例如，列印大型 EMF 檔案時，可能會發生這種情況。 頁面大小限制取決於許多因素，包括可用的虛擬記憶體數量、呼叫進程所配置的記憶體數量，以及進程堆積中的片段數量。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|