PRINTER_NOTIFY_INFO_DATA 結構

發行項
06/13/2023

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

共用方式為

PRINTER_NOTIFY_INFO_DATA 結構

語法

成員

備註

規格需求

另請參閱

意見反應

其他資源