estructura de PORT_INFO_3

La estructura PORT_INFO_3 especifica el valor de estado de un puerto de impresora.

Sintaxis

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

Miembros

dwStatus

Nuevo valor de estado del puerto. Este valor solo se usa si el miembro pszStatus es NULL.

Este miembro puede ser uno de los siguientes valores.

Valor	Significado
0	Borra el estado del puerto de la impresora.
PORT_STATUS_OFFLINE	La impresora del puerto está sin conexión.
PORT_STATUS_PAPER_JAM	La impresora del puerto tiene un atasco de papel.
PORT_STATUS_PAPER_OUT	La impresora del puerto está fuera de papel.
PORT_STATUS_OUTPUT_BIN_FULL	La papelera de salida de la impresora del puerto está llena.
PORT_STATUS_PAPER_PROBLEM	La impresora del puerto tiene un problema de papel.
PORT_STATUS_NO_TONER	La impresora del puerto está fuera del tóner.
PORT_STATUS_DOOR_OPEN	La puerta de la impresora del puerto está abierta.
PORT_STATUS_USER_INTERVENTION	La impresora del puerto requiere intervención del usuario.
PORT_STATUS_OUT_OF_MEMORY	La impresora del puerto no tiene memoria.
PORT_STATUS_TONER_LOW	La impresora del puerto está baja en tóner.
PORT_STATUS_WARMING_UP	La impresora del puerto se está calentando.
PORT_STATUS_POWER_SAVE	La impresora del puerto está en modo de conservación de energía.

pszStatus

Puntero a una nueva cadena de valor de estado de puerto de impresora que se va a establecer. Use este miembro si no hay ningún valor de estado adecuado entre los enumerados para dwStatus.

dwSeverity

Gravedad del valor de estado del puerto.

Este miembro puede ser uno de los siguientes valores.

Valor	Significado
PORT_STATUS_TYPE_ERROR	El valor de estado del puerto indica un error.
PORT_STATUS_TYPE_WARNING	El valor de estado del puerto es una advertencia.
PORT_STATUS_TYPE_INFO	El valor de estado del puerto es informativo.

Comentarios

Al establecer un valor de estado de puerto de impresora con el valor de gravedad PORT_STATUS_TYPE_ERROR, el administrador de impresión deja de enviar trabajos al puerto. El administrador de trabajos de impresión no reanuda el envío de trabajos al puerto hasta que se haga otra llamada a SetPort para borrar el estado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Winspool.h (incluye Windows.h)
Nombres Unicode y ANSI	_PORT_INFO_3W (Unicode) y _PORT_INFO_3A (ANSI)

Consulte también

Impresión

Imprimir estructuras de API de Spooler

SetPort