共用方式為


PORT_INFO_3 結構

PORT_INFO_3結構會指定印表機埠的狀態值。

語法

typedef struct _PORT_INFO_3 {
  DWORD  dwStatus;
  LPTSTR pszStatus;
  DWORD  dwSeverity;
} PORT_INFO_3, *PPORT_INFO_3;

成員

dwStatus

新的埠狀態值。 只有在 pszStatus 成員為 Null時,才會使用此值。

這個成員可以是下列其中一個值。

意義
0 清除印表機埠狀態。
PORT_STATUS_OFFLINE 埠的印表機已離線。
PORT_STATUS_PAPER_JAM 埠的印表機有紙紙。
PORT_STATUS_PAPER_OUT 埠的印表機紙張不足。
PORT_STATUS_OUTPUT_BIN_FULL 埠的印表機輸出匣已滿。
PORT_STATUS_PAPER_PROBLEM 埠的印表機有紙張問題。
PORT_STATUS_NO_TONER 埠的印表機不足。
PORT_STATUS_DOOR_OPEN 埠印表機的門已開啟。
PORT_STATUS_USER_INTERVENTION 埠的印表機需要使用者介入。
PORT_STATUS_OUT_OF_MEMORY 埠的印表機記憶體不足。
PORT_STATUS_TONER_LOW 埠的印表機對紙匣不足。
PORT_STATUS_WARMING_UP 埠的印表機已啟動。
PORT_STATUS_POWER_SAVE 埠的印表機處於電源輸入模式。

pszStatus

要設定之新印表機埠狀態值字串的指標。 如果 針對 dwStatus列出的成員之間沒有適當的狀態值,請使用這個成員。

dwSeverity

埠狀態值的嚴重性。

這個成員可以是下列其中一個值。

意義
PORT_STATUS_TYPE_ERROR 埠狀態值表示錯誤。
PORT_STATUS_TYPE_WARNING 埠狀態值是警告。
PORT_STATUS_TYPE_INFO 埠狀態值為參考。

備註

當您使用嚴重性值PORT_STATUS_TYPE_ERROR設定印表機埠狀態值時,列印多工緩衝處理器會停止將作業傳送至埠。 列印多工緩衝處理器不會繼續將作業傳送至埠,直到進行另一個 SetPort 呼叫以清除狀態為止。

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
標頭
Winspool.h (包含 Windows.h)
Unicode 與 ANSI 名稱
_PORT_INFO_3W (Unicode ) 和 anSI _PORT_INFO_3A (ANSI)

另請參閱

列印

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

SetPort