PRINT_OTHER_INFO構造体 (lmalert.h)

[アーティクル]
08/24/2023

PRINT_OTHER_INFO構造体には、印刷ジョブに関する情報が含まれています。 NetAlertRaise 関数と NetAlertRaiseEx 関数は、ジョブの印刷が完了したとき、またはプリンターが介入を必要とする場合に、PRINT_OTHER_INFO構造体を使用して情報を指定します。

構文

typedef struct _PRINT_OTHER_INFO {
  DWORD alrtpr_jobid;
  DWORD alrtpr_status;
  DWORD alrtpr_submitted;
  DWORD alrtpr_size;
} PRINT_OTHER_INFO, *PPRINT_OTHER_INFO, *LPPRINT_OTHER_INFO;

メンバー

alrtpr_jobid

型: DWORD

印刷ジョブの識別番号。

alrtpr_status

型: DWORD

印刷ジョブの状態を記述するビットマスク。

ジョブの全体的な状態を取得するには、PRJOB_QSTATUS (ビット 0 と 1) を確認します。

印刷ジョブの状態に使用できる値は、 Lmalert.h ヘッダーファイルに一覧表示されます。

値	意味
PRJOB_QS_QUEUED 0	印刷ジョブは、スケジュールを待機しているキュー内にあります。
PRJOB_QS_PAUSED 1	印刷ジョブはキュー内にありますが、一時停止されています。 (ジョブを一時停止すると、スケジュールできません。
PRJOB_QS_SPOOLING 2	印刷ジョブはスプール処理中です。
PRJOB_QS_PRINTING 3	ジョブは現在印刷中です。

印刷ジョブがPRJOB_QS_PRINTING状態の場合は、デバイスの状態 (PRJOB_DEVSTATUS) にビット 2 から 8 をチェックできます。ビット 15 も意味があります。

デバイスの状態に使用できる値は、 Lmalert.h ヘッダーファイルに一覧表示されます。

値	意味
PRJOB_COMPLETE 0x4	ジョブの印刷が完了しました。
PRJOB_INTERV 0x8	宛先プリンターにはオペレーターの介入が必要です。
PRJOB_ERROR 0x10	宛先プリンターでエラーが発生しました。
PRJOB_DESTOFFLINE 0x20	宛先プリンターがオフラインです。
PRJOB_DESTPAUSED 0x40	コピー先プリンターが一時停止しています。
PRJOB_NOTIFY 0x80	印刷アラートが発生する必要があります。
PRJOB_DESTNOPAPER 0x100	コピー先プリンターが用紙切れです。
PRJOB_DELETED 0x8000	印刷ジョブが削除されています。

alrtpr_submitted

型: DWORD

印刷ジョブが送信された時刻。この値は、GMT 1970 年 1 月 1 日の 00:00:00 以降に経過した秒数として格納されます。

alrtpr_size

型: DWORD

印刷ジョブのサイズ (バイト単位)。

注釈

追加の可変長データは、アラートメッセージバッファー内の PRINT_OTHER_INFO 構造に従います。情報は、次のように連続する null で終わる文字列の形式です。

String	説明
computername	印刷ジョブを送信したコンピューター。
username	印刷ジョブを送信したユーザー。
queuename	ジョブが送信された印刷キュー。
destination	印刷ジョブがルーティングされたプリンターの宛先 (デバイス)。
status	印刷ジョブの状態。

呼び出し元のアプリケーションは、アラートメッセージバッファー内のすべての構造体と可変長データのメモリを割り当てて解放する必要があります。

印刷アラートを発生させる方法を示すコードサンプルについては、「 NetAlertRaiseEx 」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	lmalert.h (Lm.h を含む)