StartDocW

StartDoc 関数は印刷ジョブを開始する。(Unicode)

StartDocW hdc, lpdi

hdc : [intptr] 印刷ジョブのデバイスコンテキストへのハンドル。
lpdi : [var] ドキュメントファイル名と出力ファイル名を含む DOCINFO 構造体へのポインタ。

(プラグイン / モジュール : gdi32.dll)

解説

StartDoc 関数は印刷ジョブを開始する。(Unicode)

[戻り値]
関数が成功した場合、戻り値はゼロより大きい。この値はドキュメントの印刷ジョブ識別子である。関数が失敗した場合、戻り値はゼロ以下である。

[備考]
注:
これはブロッキングまたは同期関数であり、すぐに返らない可能性がある。この関数がどれだけ早く返るかは、ネットワーク状態、印刷サーバの設定、プリンタドライバの実装といった、アプリケーションの作成時に予測が難しい実行時要因に依存する。ユーザインターフェイスとの対話を管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しないように見えることがある。アプリケーションは印刷ジョブを開始する直前に
StartDoc
関数を呼び出すべきである。この関数を使うことで、複数ページのドキュメントが他の印刷ジョブと混ざらないようにする。アプリケーションは、StartDoc
から返された値を使って印刷ジョブの優先度を取得または設定できる。GetJob または SetJob 関数を呼び出し、必要な引数の 1
つとしてこの値を提供する。

情報