Share via

PRINTER_NOTIFY_INFO_DATA 結構

  • 發行項

PRINTER_NOTIFY_INFO_DATA結構會識別作業或印表機資訊欄位，並提供該欄位的目前資料。

FindNextPrinterChangeNotification函式會傳回PRINTER_NOTIFY_INFO結構，其中包含PRINTER_NOTIFY_INFO_DATA結構的陣列。

語法

typedef struct _PRINTER_NOTIFY_INFO_DATA {
  WORD  Type;
  WORD  Field;
  DWORD Reserved;
  DWORD Id;
  union {
    DWORD  adwData[2];
    struct {
      DWORD  cbBuf;
      LPVOID pBuf;
    } Data;
  } NotifyData;
} PRINTER_NOTIFY_INFO_DATA, *PPRINTER_NOTIFY_INFO_DATA; ;

成員

類型

指出提供的資訊類型。 這個成員可以是下列其中一個值。

值 意義
JOB_NOTIFY_TYPE
0x01
 表示 Field 成員指定JOB_NOTIFY_FIELD_* 常數。
PRINTER_NOTIFY_TYPE
0x00
 表示 Field 成員指定PRINTER_NOTIFY_FIELD_* 常數。

欄位

指出已變更的欄位。 如需可能值的清單，請參閱一節。

已保留

保留的。

Id

如果 Type 成員指定JOB_NOTIFY_TYPE，則表示作業識別碼。 如果 Type 成員指定PRINTER_NOTIFY_TYPE，則此成員為未定義。

NotifyData

以 Type 和 Field 成員為基礎的資料資訊聯集。 如需與每個欄位相關聯之資料類型的描述，請參閱一節。

adwData[2]

兩個 DWORD 值的陣列。 如需僅使用單一 DWORD的資訊欄位，資料位於 adwData [0]。

Data

cbBuf

表示 pBuf所指向緩衝區的大小，以位元組為單位。

pBuf

緩衝區的指標，其中包含欄位的目前資料。

備註

如果 Type 成員指定PRINTER_NOTIFY_TYPE， Field 成員可以是下列其中一個值。

欄位 資料類型 值
PRINTER_NOTIFY_FIELD_SERVER_NAME 不支援。 0x00
PRINTER_NOTIFY_FIELD_PRINTER_NAME pBuf 是包含印表機名稱之 Null 終止字串的指標。 0x01
PRINTER_NOTIFY_FIELD_SHARE_NAME pBuf 是 Null 終止字串的指標，可識別印表機的共用點。 0x02
PRINTER_NOTIFY_FIELD_PORT_NAME pBuf 是 Null 終止字串的指標，其中包含列印工作將列印至的埠名稱。 如果選取 [印表機共用]，這是以逗號分隔的埠清單。 0x03
PRINTER_NOTIFY_FIELD_DRIVER_NAME pBuf 是包含印表機驅動程式名稱之 Null 終止字串的指標。 0x04
PRINTER_NOTIFY_FIELD_COMMENT pBuf 是 Null 終止字串的指標，其中包含新的批註字串，這通常是印表機的簡短描述。 0x05
PRINTER_NOTIFY_FIELD_LOCATION pBuf 是 Null 終止字串的指標，其中包含印表機的新實體位置 (，例如 「Bldg. 38， Room 1164」) 。 0x06
PRINTER_NOTIFY_FIELD_DEVMODE pBuf 是 DEVMODE 結構的指標，可定義預設印表機資料，例如紙張方向和解析度。 0x07
PRINTER_NOTIFY_FIELD_SEPFILE pBuf 是 Null 終止字串的指標，指定用來建立分隔符號頁面的檔案名。 此頁面用來分隔傳送至印表機的列印工作。 0x08
PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR pBuf 是 Null 終止字串的指標，指定印表機所使用的列印處理器名稱。 0x09
PRINTER_NOTIFY_FIELD_PARAMETERS pBuf 是指定預設列印處理器參數之 Null 終止字串的指標。 0x0A
PRINTER_NOTIFY_FIELD_DATATYPE pBuf 是 Null 終止字串的指標，指定用來記錄列印工作的資料類型。 0x0B
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR pBuf 是印表機 SECURITY_DESCRIPTOR 結構的指標。 如果沒有安全性描述項，指標可能是 Null 。 0x0C
PRINTER_NOTIFY_FIELD_ATTRIBUTES adwData [0] 指定印表機屬性，它可以是下列其中一個值：
PRINTER_ATTRIBUTE_QUEUED
PRINTER_ATTRIBUTE_DIRECT
PRINTER_ATTRIBUTE_DEFAULT
PRINTER_ATTRIBUTE_SHARED
 0x0D
PRINTER_NOTIFY_FIELD_PRIORITY adwData [0] 指定多工緩衝處理常式用來路由列印工作的優先順序值。 0x0E
PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY adwData [0] 指定指派給每個列印工作的預設優先順序值。 0x0F
PRINTER_NOTIFY_FIELD_START_TIME adwData [0] 指定印表機列印工作的最早時間。 (此值是在 12：00 A.M.) 之後經過幾分鐘內指定 0x10
PRINTER_NOTIFY_FIELD_UNTIL_TIME adwData [0] 會指定印表機列印工作的最新版本。 (此值是在 12：00 A.M.) 之後經過幾分鐘內指定 0x11
PRINTER_NOTIFY_FIELD_STATUS adwData [0] 指定印表機狀態。 如需可能值的清單，請參閱 PRINTER_INFO_2 結構。 0x12
PRINTER_NOTIFY_FIELD_STATUS_STRING 不支援。 0x13
PRINTER_NOTIFY_FIELD_CJOBS adwData [0] 指定已針對印表機排入佇列的列印工作數目。 0x14
PRINTER_NOTIFY_FIELD_AVERAGE_PPM adwData [0] 指定印表機上列印的每分鐘平均頁數。 0x15
PRINTER_NOTIFY_FIELD_TOTAL_PAGES 不支援。 0x16
PRINTER_NOTIFY_FIELD_PAGES_PRINTED 不支援。 0x17
PRINTER_NOTIFY_FIELD_TOTAL_BYTES 不支援。 0x18
PRINTER_NOTIFY_FIELD_BYTES_PRINTED 不支援。 0x19
PRINTER_NOTIFY_FIELD_OBJECT_GUID 如果物件 GUID 變更，就會設定此設定。 0x1A
PRINTER_NOTIFY_FIELD_FRIENDLY_NAME 如果印表機連接已重新命名，則會設定此設定。 0x1B

如果 Type 成員指定JOB_NOTIFY_TYPE， Field 成員可以是下列其中一個值。

欄位 資料類型 值
JOB_NOTIFY_FIELD_PRINTER_NAME pBuf 是 Null 終止字串的指標，其中包含工作多工緩衝處理的印表機名稱。 0x00
JOB_NOTIFY_FIELD_MACHINE_NAME pBuf 是 Null 終止字串的指標，指定建立列印工作的電腦名稱稱。 0x01
JOB_NOTIFY_FIELD_PORT_NAME pBuf 是 Null 終止字串的指標，可識別用來將資料傳輸到印表機的埠 (s) 。 如果印表機連線到多個埠，埠的名稱會以逗號分隔 (例如 「LPT1：，LPT2：，LPT3：」) 。 0x02
JOB_NOTIFY_FIELD_USER_NAME pBuf 是 Null 終止字串的指標，指定傳送列印工作的使用者名稱。 0x03
JOB_NOTIFY_FIELD_NOTIFY_NAME pBuf 是 Null 終止字串的指標，指定列印工作時或列印工作時發生錯誤時應通知的使用者名稱。 0x04
JOB_NOTIFY_FIELD_DATATYPE pBuf 是 Null 終止字串的指標，指定用來記錄列印工作的資料類型。 0x05
JOB_NOTIFY_FIELD_PRINT_PROCESSOR pBuf 是 Null 終止字串的指標，指定要用來列印工作的列印處理器名稱。 0x06
JOB_NOTIFY_FIELD_PARAMETERS pBuf 是指定列印處理器參數之 Null 終止字串的指標。 0x07
JOB_NOTIFY_FIELD_DRIVER_NAME pBuf 是 Null 終止字串的指標，指定應該用來處理列印工作的印表機驅動程式名稱。 0x08
JOB_NOTIFY_FIELD_DEVMODE pBuf 是 DEVMODE 結構的指標，其中包含印表機驅動程式的裝置初始化和環境資料。 0x09
JOB_NOTIFY_FIELD_STATUS adwData [0] 會指定作業狀態。 如需可能值的清單，請參閱 JOB_INFO_2 結構。 0x0A
JOB_NOTIFY_FIELD_STATUS_STRING pBuf 是指定列印工作狀態之 Null 終止字串的指標。 0x0B
JOB_NOTIFY_FIELD_SECURITY_DESCRIPTOR 不支援。 0x0C
JOB_NOTIFY_FIELD_DOCUMENT pBuf 是 null 終止字串的指標，指定列印工作的名稱 (例如「MS-WORD： Review.doc」) 。 0x0D
JOB_NOTIFY_FIELD_PRIORITY adwData [0] 指定作業優先順序。 0x0E
JOB_NOTIFY_FIELD_POSITION adwData [0] 會指定列印佇列中作業的位置。 0x0F
JOB_NOTIFY_FIELD_SUBMITTED pBuf 是 SYSTEMTIME 結構的指標，指定提交作業的時間。 0x10
JOB_NOTIFY_FIELD_START_TIME adwData [0] 指定可以列印工作的最早時間。 (此值是在 12：00 A.M.) 之後經過幾分鐘內指定 0x11
JOB_NOTIFY_FIELD_UNTIL_TIME adwData [0] 會指定列印工作的最新版本。 (此值是在 12：00 A.M.) 之後經過幾分鐘內指定 0x12
JOB_NOTIFY_FIELD_TIME adwData [0] 指定自作業開始列印以來經過的總時間，以秒為單位。 0x13
JOB_NOTIFY_FIELD_TOTAL_PAGES adwData [0] 會指定作業的頁面大小。 0x14
JOB_NOTIFY_FIELD_PAGES_PRINTED adwData [0] 會指定已列印的頁數。 0x15
JOB_NOTIFY_FIELD_TOTAL_BYTES adwData [0] 指定作業的大小，以位元組為單位。 0x16
JOB_NOTIFY_FIELD_BYTES_PRINTED adwData [0] 指定已列印在此作業上的位元組數目。 針對此欄位，當位元組傳送至印表機時，變更通知物件會發出訊號。 0x17

規格需求

需求 值
最低支援的用戶端
 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限桌面應用程式]
標頭
Winspool.h (包含 Windows.h)

另請參閱

列印

列印多工緩衝處理常式 API 結構

DEVMODE

FindNextPrinterChangeNotification

JOB_INFO_2

PRINTER_INFO_2

PRINTER_NOTIFY_INFO

SECURITY_DESCRIPTOR

SYSTEMTIME