PRINTER_INFO_2 結構

發行項
06/13/2023

PRINTER_INFO_2結構會指定詳細的印表機資訊。

語法

typedef struct _PRINTER_INFO_2 {
  LPTSTR               pServerName;
  LPTSTR               pPrinterName;
  LPTSTR               pShareName;
  LPTSTR               pPortName;
  LPTSTR               pDriverName;
  LPTSTR               pComment;
  LPTSTR               pLocation;
  LPDEVMODE            pDevMode;
  LPTSTR               pSepFile;
  LPTSTR               pPrintProcessor;
  LPTSTR               pDatatype;
  LPTSTR               pParameters;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Attributes;
  DWORD                Priority;
  DWORD                DefaultPriority;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                Status;
  DWORD                cJobs;
  DWORD                AveragePPM;
} PRINTER_INFO_2, *PPRINTER_INFO_2;

成員

pServerName

識別控制印表機之伺服器的 Null 終止字串指標。如果此字串為 Null，則會在本機控制印表機。

pPrinterName

指定印表機名稱之 Null 終止字串的指標。

pShareName

識別印表機共用點之 Null 終止字串的指標。 (只有在已為 Attributes 成員設定PRINTER_ATTRIBUTE_SHARED常數時，才會使用此字串。)

pPortName

Null 終止字串的指標，可識別用來將資料傳送至印表機的埠 (s) 。如果印表機連線到多個埠，則每個埠的名稱必須以逗號分隔 (，例如「LPT1：，LPT2：，LPT3：」) 。

pDriverName

指定印表機驅動程式名稱之 Null 終止字串的指標。

pComment

以 Null 結尾的字串指標，提供印表機的簡短描述。

pLocation

指定 (印表機實體位置的 null 終止字串指標，例如「Bldg.38，Room 1164」) 。

pDevMode

DEVMODE結構的指標，定義預設印表機資料，例如紙張方向和解析度。

pSepFile

Null 終止字串的指標，指定用來建立分隔符號頁面的檔案名。此頁面用來分隔傳送至印表機的列印工作。

pPrintProcessor

Null 終止字串的指標，指定印表機所使用的列印處理器名稱。您可以使用 EnumPrintProcessors 函式來取得伺服器上安裝的列印處理器清單。

pDatatype

Null 終止字串的指標，指定用來記錄列印工作的資料類型。您可以使用 EnumPrintProcessorDatatypes 函式來取得特定列印處理器所支援的資料類型清單。

pParameters

指定預設列印處理器參數之 Null 終止字串的指標。

pSecurityDescriptor

印表機 SECURITY_DESCRIPTOR 結構的指標。此成員可以是 Null。

屬性

印表機屬性。這個成員可以是下列值的任何合理組合。

值	意義
PRINTER_ATTRIBUTE_DIRECT	作業會直接傳送至印表機， (它不會) 多工緩衝處理。
PRINTER_ATTRIBUTE_DO_COMPLETE_FIRST	如果 set 和 printer 是針對列印時多工緩衝處理設定，則已完成多工緩衝處理的任何作業會排程在未完成多工緩衝處理的工作之前列印。
PRINTER_ATTRIBUTE_ENABLE_DEVQ	如果設定，則會呼叫 DevQueryPrint 。如果檔和印表機設定不符，DevQueryPrint可能會失敗。設定此旗標會導致不相符的檔保留在佇列中。
PRINTER_ATTRIBUTE_HIDDEN	保留的。
PRINTER_ATTRIBUTE_KEEPPRINTEDJOBS	如果設定，則會在列印工作之後保留。如果未設定，則會刪除作業。
PRINTER_ATTRIBUTE_LOCAL	印表機是本機印表機。
PRINTER_ATTRIBUTE_NETWORK	印表機是網路印表機連線。
PRINTER_ATTRIBUTE_PUBLISHED	指出印表機是否在目錄服務中發佈。
PRINTER_ATTRIBUTE_QUEUED	如果已設定，印表機多工緩衝處理後就會開始列印最後一頁。如果未設定且PRINTER_ATTRIBUTE_DIRECT未設定，印表機多工緩衝處理時會列印。
PRINTER_ATTRIBUTE_RAW_ONLY	表示只有原始資料類型列印工作可以多工緩衝處理。
PRINTER_ATTRIBUTE_SHARED	印表機已共用。

在 Windows XP 和更新版本的 Windows 中，也可以使用下列值。

值	意義
PRINTER_ATTRIBUTE_FAX	如果設定，印表機是傳真印表機。這只能由 AddPrinter設定，但可由 EnumPrinters 和 GetPrinter擷取。

在 Windows Vista 和更新版本的 Windows 中，也可以使用下列值。

值	意義
PRINTER_ATTRIBUTE_FRIENDLY_NAME	電腦已連線到此印表機，並為其指定易記名稱。
PRINTER_ATTRIBUTE_MACHINE	印表機是每部機器的連線。
PRINTER_ATTRIBUTE_PUSHED_USER	印表機是使用推播印表機連線使用者原則來安裝。
PRINTER_ATTRIBUTE_PUSHED_MACHINE	印表機是使用推播印表機連線電腦原則安裝。

在 Windows Server 2003 中，也可以使用下列值。

值	意義
PRINTER_ATTRIBUTE_TS	指出印表機目前是透過終端機伺服器連線。

優先順序

多工緩衝處理用來路由列印工作的優先順序值。

DefaultPriority

指派給每個列印工作的預設優先順序值。

StartTime

印表機將列印工作的最早時間。此值以自上午 12：00 GMT 起經過的分鐘數表示， (Greenwich Mean Time) 。

UntilTime

印表機將列印工作的最新時間。此值以自上午 12：00 GMT 起經過的分鐘數表示， (Greenwich Mean Time) 。

狀態

印表機狀態。這個成員可以是下列值的任何合理組合。

值	意義
PRINTER_STATUS_BUSY	印表機忙碌中。
PRINTER_STATUS_DOOR_OPEN	印表機門已開啟。
PRINTER_STATUS_ERROR	印表機處於錯誤狀態。
PRINTER_STATUS_INITIALIZING	印表機初始化中。
PRINTER_STATUS_IO_ACTIVE	印表機處於作用中的輸入/輸出狀態
PRINTER_STATUS_MANUAL_FEED	印表機處於手動摘要狀態。
PRINTER_STATUS_NO_TONER	印表機的碳粉已用完。
PRINTER_STATUS_NOT_AVAILABLE	印表機無法列印。
PRINTER_STATUS_OFFLINE	印表機為離線。
PRINTER_STATUS_OUT_OF_MEMORY	印表機記憶體不足。
PRINTER_STATUS_OUTPUT_BIN_FULL	印表機的輸出紙匣已滿。
PRINTER_STATUS_PAGE_PUNT	印表機無法列印目前的頁面。
PRINTER_STATUS_PAPER_JAM	紙張在印表機中已卡住
PRINTER_STATUS_PAPER_OUT	印表機紙張用完。
PRINTER_STATUS_PAPER_PROBLEM	印表機有紙張問題。
PRINTER_STATUS_PAUSED	印表機已暫停。
PRINTER_STATUS_PENDING_DELETION	正在刪除印表機。
PRINTER_STATUS_POWER_SAVE	印表機處於省電模式。
PRINTER_STATUS_PRINTING	印表機正在列印。
PRINTER_STATUS_PROCESSING	印表機正在處理列印工作。
PRINTER_STATUS_SERVER_UNKNOWN	印表機狀態不明。
PRINTER_STATUS_TONER_LOW	印表機的紙紙不足。
PRINTER_STATUS_USER_INTERVENTION	印表機發生錯誤，需要使用者執行某些動作。
PRINTER_STATUS_WAITING	印表機正在等候。
PRINTER_STATUS_WARMING_UP	印表機準備中。

cJobs

已針對印表機排入佇列的列印工作數目。

AveragePPM

印表機上列印的每分鐘平均頁數。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Winspool.h (包含 Windows.h)
Unicode 與 ANSI 名稱	_PRINTER_INFO_2W (Unicode ) 和 _PRINTER_INFO_2A (ANSI)

另請參閱

列印
列印多工緩衝處理器 API 結構
DEVMODE
EnumPrinters
PRINTER_INFO_1
PRINTER_INFO_3
PRINTER_INFO_4
SECURITY_DESCRIPTOR

共用方式為

PRINTER_INFO_2 結構

語法

成員

規格需求

另請參閱

意見反應

其他資源