Share via


abortDoc 函式 (wingdi.h)

AbortDoc 函式會停止目前的列印作業,並清除自上次呼叫 StartDoc 函式之後所繪製的所有專案。

語法

int AbortDoc(
  [in] HDC hdc
);

參數

[in] hdc

列印作業之裝置內容的句柄。

傳回值

如果函式成功,則傳回值大於零。

如果函式失敗,傳回值會SP_ERROR。

備註

注意 這是封鎖或同步函式,可能不會立即傳回。 此函式傳回的速度取決於運行時間因素,例如網路狀態、列印伺服器設定和印表機驅動程序實作—撰寫應用程式時難以預測的因素。 從管理與使用者介面互動的線程呼叫此函式,可能會使應用程式看起來沒有回應。
 
應用程式應該呼叫 AbortDoc 函式,以在發生錯誤時停止列印作業,或在使用者取消該作業之後停止列印作業。 若要結束成功的列印作業,應用程式應該呼叫 EndDoc 函式。

如果列印管理員用來啟動列印作業,則呼叫 AbortDoc 會清除整個多任務緩衝處理作業,讓印表機不會收到任何訊息。 如果列印管理員未用來啟動列印作業,數據可能已經傳送至印表機。 在此情況下,印表機驅動程式會在可能的情況下) 並結束列印作業時重設印表機 (。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

EndDoc

列印多工緩衝處理器 API 函式

列印

SetAbortProc

StartDoc