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时，打印后台处理程序将停止向端口发送作业。在进行另一个 SetPort 调用以清除状态之前，打印后台处理程序不会继续将作业发送到端口。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Winspool.h (包括 Windows.h)
Unicode 和 ANSI 名称	_PORT_INFO_3W (Unicode) 和 _PORT_INFO_3A (ANSI)