StartDocW 関数 (wingdi.h)
StartDoc 関数は、印刷ジョブを開始します。
構文
int StartDocW(
[in] HDC hdc,
[in] const DOCINFOW *lpdi
);
パラメーター
[in] hdc
印刷ジョブのデバイス コンテキストへのハンドル。
[in] lpdi
ドキュメント ファイルの名前と出力ファイルの名前を含む DOCINFO 構造体へのポインター。
戻り値
関数が成功した場合、戻り値は 0 より大きくなります。 この値は、ドキュメントの印刷ジョブ識別子です。
関数が失敗した場合、戻り値は 0 以下になります。
備考
注 これはブロック関数または同期関数であり、すぐに戻らない場合があります。 この関数が返す速度は、ネットワーク状態、プリント サーバーの構成、プリンター ドライバーの実装などの実行時の要因によって異なります。これは、アプリケーションの記述時に予測が困難な要因です。 ユーザー インターフェイスとの対話を管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しなくなる可能性があります。
アプリケーションは、StartDoc によって返される値を使用して、印刷ジョブの優先順位を取得または設定できます。
例
この関数を使用するサンプル プログラムについては、「方法: GDI Print APIを使用して印刷する」を参照してください。
手記
wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして StartDoc を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | wingdi.h (Windows.h を含む) |
| ライブラリ | Gdi32.lib |
| DLL | Gdi32.dll |
関連項目
DOCINFO を
EndDoc の
GetJob を
SetJob の