JOB_INFO_1構造体

  • [アーティクル]

JOB_INFO_1構造体は、ジョブ ID 値、ジョブがスプールされるプリンターの名前、印刷ジョブを作成したマシンの名前、印刷ジョブを所有するユーザーの名前などの印刷ジョブ情報を指定します。

構文

typedef struct _JOB_INFO_1 {
  DWORD      JobId;
  LPTSTR     pPrinterName;
  LPTSTR     pMachineName;
  LPTSTR     pUserName;
  LPTSTR     pDocument;
  LPTSTR     pDatatype;
  LPTSTR     pStatus;
  DWORD      Status;
  DWORD      Priority;
  DWORD      Position;
  DWORD      TotalPages;
  DWORD      PagesPrinted;
  SYSTEMTIME Submitted;
} JOB_INFO_1, *PJOB_INFO_1;

メンバー

JobId

ジョブ識別子。

pPrinterName

ジョブがスプールされるプリンターの名前を指定する null で終わる文字列へのポインター。

pMachineName

印刷ジョブを作成したコンピューターの名前を指定する null で終わる文字列へのポインター。

pUserName

印刷ジョブを所有するユーザーの名前を指定する null で終わる文字列へのポインター。

pDocument

印刷ジョブの名前 ("MS-WORD: Review.doc" など) を指定する null で終わる文字列へのポインター。

pDatatype

印刷ジョブの記録に使用されるデータの種類を指定する null で終わる文字列へのポインター。

pStatus

印刷ジョブの状態を指定する null で終わる文字列へのポインター。 このメンバーは Status の前に確認する必要があります。 pStatus が NULL の場合、状態は Status メンバーの内容によって定義されます。

状態

ジョブの状態。 このメンバーの値は、0 または次の値の 1 つ以上の組み合わせにすることができます。 値 0 は、文書のスプールが完了した後に印刷キューが一時停止されたことを示します。

値 説明
JOB_STATUS_BLOCKED_DEVQ ドライバーはジョブを印刷できません。
JOB_STATUS_COMPLETE Windows XP 以降: ジョブはプリンターに送信されますが、ジョブがまだ印刷されていない可能性があります。
詳細については、「解説」を参照してください。
JOB_STATUS_DELETED ジョブが削除されました。
JOB_STATUS_DELETING ジョブが削除されています。
JOB_STATUS_ERROR エラーがジョブに関連付けられています。
JOB_STATUS_OFFLINE プリンターがオフラインです。
JOB_STATUS_PAPEROUT プリンターの用紙が切れている。
JOB_STATUS_PAUSED ジョブが一時停止しています。
JOB_STATUS_PRINTED ジョブが印刷されました。
JOB_STATUS_PRINTING ジョブは印刷中です。
JOB_STATUS_RESTART ジョブが再起動されました。
JOB_STATUS_RETAINED Windows Vista 以降: ジョブは印刷キューに保持されており、削除できません。 次の問題によって発生することがあります。
1) ジョブは SetJob の呼び出しによって手動で保持され、スプーラーはジョブの解放を待機しています。
2) ジョブは印刷を完了していないため、自動的に削除する前に印刷を完了する必要があります。
印刷ジョブ コマンドの詳細については、「 SetJob 」を参照してください。
JOB_STATUS_SPOOLING ジョブがスプール中です。
JOB_STATUS_USER_INTERVENTION プリンターにエラーが発生し、ユーザーが何かを行う必要があります。

優先順位

ジョブの優先度。 このメンバーは、次の値のいずれか、または 1 ~ 99 (MIN_PRIORITY ~ MAX_PRIORITY) の範囲にすることができます。

値 説明
MIN_PRIORITY 最小優先度。
MAX_PRIORITY 最大優先度。
DEF_PRIORITY 既定の優先度。

Position

印刷キュー内のジョブの位置。

TotalPages

ドキュメントに含まれるページの合計数。 印刷ジョブにページ区切り情報が含まれていない場合、この値は 0 になることがあります。

PagesPrinted

印刷されたページの数。 印刷ジョブにページ区切り情報が含まれていない場合、この値は 0 になることがあります。

送信

この文書がスプールされた時刻を指定する SYSTEMTIME 構造体。

この時刻の値は、世界時座標 (UTC) 形式です。 表示する前に、ローカル時刻の値に変換する必要があります。 FileTimeToLocalFileTime 関数を使用して変換を実行できます。

注釈

TrueEndOfJob をサポートしていないポート モニターは、ジョブがプリンターに送信された直後にJOB_STATUS_PRINTEDとしてジョブを設定します。

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Winspool.h (Windows.h を含む)
Unicode 名と ANSI 名
 _JOB_INFO_1W (Unicode) と _JOB_INFO_1A (ANSI)

関連項目

印刷

印刷スプーラー API 構造体

EnumJobs

GetJob

SetJob