PRINT_OTHER_INFO 結構 (lmalert.h)

發行項
02/28/2024

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

提交列印作業的時間。此值會儲存為自 00：00：00：00 之後，1970 年 1 月 1 日 GMT 所經過的秒數。

alrtpr_size

類型： DWORD

列印作業的大小，以位元組為單位。

備註

其他可變長度數據會遵循警示訊息緩衝區中的 PRINT_OTHER_INFO 結構。資訊的格式為連續 Null 終止的字元字串，如下所示。

String	意義
computername	提交列印作業的計算機。
使用者名稱	提交列印作業的使用者。
queuename	提交作業的列印佇列。
目的地	印表機目的地 (裝置) 已路由傳送列印作業。
status	列印作業的狀態。

呼叫的應用程式必須配置並釋放警示訊息緩衝區中所有結構和可變長度數據的記憶體。

如需示範如何引發列印警示的程式碼範例，請參閱 NetAlertRaiseEx 。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	lmalert.h (包括 Lm.h)