共用方式為


startDocW 函式 (wingdi.h)

StartDoc函式會啟動列印工作。

語法

int StartDocW(
  [in] HDC            hdc,
  [in] const DOCINFOW *lpdi
);

參數

[in] hdc

列印工作之裝置內容的控制碼。

[in] lpdi

DOCINFO結構的指標,其中包含檔檔的名稱和輸出檔的名稱。

傳回值

如果函式成功,則傳回值大於零。 此值是檔的列印工作識別碼。

如果函式失敗,則傳回值小於或等於零。

備註

注意 這是封鎖或同步函式,可能不會立即傳回。 此函式傳回的速度取決於執行時間因素,例如網路狀態、列印伺服器組態和印表機驅動程式實作—撰寫應用程式時難以預測的因素。 從管理與使用者介面互動的執行緒呼叫此函式,可能會讓應用程式看起來沒有回應。
 
應用程式應該在開始列印工作之前立即呼叫 StartDoc 函式。 使用此函式可確保多頁檔不會與其他列印工作交錯。

應用程式可以使用 StartDoc 傳回的值來擷取或設定列印工作的優先順序。 呼叫 GetJobSetJob 函式,並提供此值作為其中一個必要引數。

範例

如需使用此函式的範例程式,請參閱 How To: Print Using the GDI Print API

注意

wingdi.h 標頭會將 StartDoc 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

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

另請參閱

DOCINFO

EndDoc

GetJob

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

列印

SetJob