struttura PORT_INFO_3

La struttura PORT_INFO_3 specifica il valore di stato di una porta della stampante.

Sintassi

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

Members

dwStatus

Nuovo valore di stato della porta. Questo valore viene usato solo se il membro pszStatus è NULL.

Questo membro può essere uno dei valori seguenti.

Valore	Significato
0	Cancella lo stato della porta della stampante.
PORT_STATUS_OFFLINE	La stampante della porta è offline.
PORT_STATUS_PAPER_JAM	La stampante della porta ha una marmellata di carta.
PORT_STATUS_PAPER_OUT	La stampante della porta è fuori carta.
PORT_STATUS_OUTPUT_BIN_FULL	Il contenitore di output della stampante della porta è pieno.
PORT_STATUS_PAPER_PROBLEM	La stampante della porta presenta un problema di carta.
PORT_STATUS_NO_TONER	La stampante della porta è fuori dal toner.
PORT_STATUS_DOOR_OPEN	La porta della stampante del porto è aperta.
PORT_STATUS_USER_INTERVENTION	La stampante della porta richiede l'intervento dell'utente.
PORT_STATUS_OUT_OF_MEMORY	La stampante della porta non è in memoria.
PORT_STATUS_TONER_LOW	La stampante della porta è bassa sul toner.
PORT_STATUS_WARMING_UP	La stampante della porta si sta scaldando.
PORT_STATUS_POWER_SAVE	La stampante della porta è in modalità di risparmio energia.

pszStatus

Puntatore a una nuova stringa di valore dello stato della porta della stampante da impostare. Utilizzare questo membro se non è presente alcun valore di stato appropriato tra quelli elencati per dwStatus.

dwSeverity

Gravità del valore dello stato della porta.

Questo membro può essere uno dei valori seguenti.

Valore	Significato
PORT_STATUS_TYPE_ERROR	Il valore di stato della porta indica un errore.
PORT_STATUS_TYPE_WARNING	Il valore dello stato della porta è un avviso.
PORT_STATUS_TYPE_INFO	Il valore dello stato della porta è informativo.

Commenti

Quando si imposta un valore di stato della porta della stampante con il valore di gravità PORT_STATUS_TYPE_ERROR, lo spooler di stampa interrompe l'invio di processi alla porta. Lo spooler di stampa non riprende l'invio di processi alla porta finché non viene effettuata un'altra chiamata SetPort per cancellare lo stato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Nomi Unicode e ANSI	_PORT_INFO_3W (Unicode) e _PORT_INFO_3A (ANSI)

Vedi anche

Stampa

Stampare le strutture dell'API Spooler

SetPort