2.2.1.9.3 PORT_INFO_3

The PORT_INFO_3 structure provides information about a port.<49>

 typedef struct _PORT_INFO_3 {
   DWORD dwStatus;
   [string] wchar_t* pszStatus;
   DWORD dwSeverity;
 } PORT_INFO_3;

dwStatus: The new port status. This value MUST be one of the following.

Name/value

Description

PORT_STATUS_CLEAR

0x00000000

Clears the printer port status.

PORT_STATUS_OFFLINE

0x00000001

The port’s printer is offline.

PORT_STATUS_PAPER_JAM

0x00000002

The port’s printer has a paper jam.

PORT_STATUS_PAPER_OUT

0x00000003

The port’s printer is out of paper.

PORT_STATUS_OUTPUT_BIN_FULL

0x00000004

The port’s printer's output bin is full.

PORT_STATUS_PAPER_PROBLEM

0x00000005

The port’s printer has a paper problem.

PORT_STATUS_NO_TONER

0x00000006

The port’s printer is out of toner.

PORT_STATUS_DOOR_OPEN

0x00000007

The door of the port’s printer is open.

PORT_STATUS_USER_INTERVENTION

0x00000008

The port’s printer requires user intervention.

PORT_STATUS_OUT_OF_MEMORY

0x00000009

The port’s printer is out of memory.

PORT_STATUS_TONER_LOW

0x0000000A

The port’s printer is low on toner.

PORT_STATUS_WARMING_UP

0x0000000B

The port’s printer is warming up.

PORT_STATUS_POWER_SAVE

0x0000000C

The port’s printer is in a power-conservation mode.

pszStatus: An optional pointer to a string that specifies a status description.

dwSeverity: The severity of the port status value. This value MUST be one of the following.

Name/value

Description

PORT_STATUS_TYPE_ERROR

0x00000001

The port status value indicates an error.

PORT_STATUS_TYPE_WARNING

0x00000002

The port status value is a warning.

PORT_STATUS_TYPE_INFO

0x00000003

The port status value is informational.

All members not defined in this section are specified in sections 2.2.1.3.5 and 2.2.1.3.