PORT_INFO_3 structure

Article
06/13/2023

La structure PORT_INFO_3 spécifie la valeur status d’un port d’imprimante.

Syntaxe

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

Membres

dwStatus

Valeur du nouveau port status. Cette valeur est utilisée uniquement si le membre pszStatus a la valeur NULL.

Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
0	Efface le port de l’imprimante status.
PORT_STATUS_OFFLINE	L’imprimante du port est hors connexion.
PORT_STATUS_PAPER_JAM	L’imprimante du port a un bourrage de papier.
PORT_STATUS_PAPER_OUT	L’imprimante du port est en papier.
PORT_STATUS_OUTPUT_BIN_FULL	Le bac de sortie de l’imprimante du port est plein.
PORT_STATUS_PAPER_PROBLEM	L’imprimante du port présente un problème de papier.
PORT_STATUS_NO_TONER	L’imprimante du port est hors toner.
PORT_STATUS_DOOR_OPEN	La porte de l’imprimante du port est ouverte.
PORT_STATUS_USER_INTERVENTION	L’imprimante du port nécessite l’intervention de l’utilisateur.
PORT_STATUS_OUT_OF_MEMORY	La mémoire de l’imprimante du port est insuffisante.
PORT_STATUS_TONER_LOW	L’imprimante du port est faible en toner.
PORT_STATUS_WARMING_UP	L’imprimante du port s’échauffe.
PORT_STATUS_POWER_SAVE	L’imprimante du port est en mode d’économie d’alimentation.

pszStatus

Pointeur vers un nouveau port d’imprimante status chaîne de valeur à définir. Utilisez ce membre s’il n’existe aucune valeur de status appropriée parmi ceux répertoriés pour dwStatus.

dwSeverity

Gravité de la valeur status port.

Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
PORT_STATUS_TYPE_ERROR	La valeur de port status indique une erreur.
PORT_STATUS_TYPE_WARNING	La valeur de port status est un avertissement.
PORT_STATUS_TYPE_INFO	La valeur de port status est informationnelle.

Notes

Lorsque vous définissez un port d’imprimante status valeur avec la valeur de gravité PORT_STATUS_TYPE_ERROR, le spouleur d’impression cesse d’envoyer des travaux au port. Le spouleur d’impression ne reprend pas l’envoi de travaux vers le port tant qu’un autre appel SetPort n’a pas été effectué pour effacer le status.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Winspool.h (inclure Windows.h)
Noms Unicode et ANSI	_PORT_INFO_3W (Unicode) et _PORT_INFO_3A (ANSI)

Voir aussi

Impression
Imprimer les structures de l’API spouleur
SetPort

Partager via