Partager via


PORT_INFO_3 structure

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