Compartir a través de

estructura de PORT_INFO_3

  • Artículo

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