Structure de l’imprimante _ info _ 4

La structure de l' imprimante _ info _ 4 spécifie des informations générales sur l’imprimante.

La structure peut être utilisée pour récupérer des informations d’imprimante minimales sur un appel à EnumPrinters. Un tel appel est un moyen simple et rapide de récupérer les noms et les attributs de toutes les imprimantes installées localement sur un système et toutes les connexions d’imprimante distantes qu’un utilisateur a établies.

Syntaxe

typedef struct _PRINTER_INFO_4 {
  LPTSTR pPrinterName;
  LPTSTR pServerName;
  DWORD  Attributes;
} PRINTER_INFO_4, *PPRINTER_INFO_4;

Membres

pPrinterName

Pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom de l’imprimante (locale ou distante).

pServerName

Pointeur vers une chaîne se terminant par un caractère null qui est le nom du serveur.

Attributs

Spécifie des informations sur les données retournées.

Valeur Signification
_attribut imprimante _ local L’imprimante est une imprimante locale.
attribut d’imprimante _ _ réseau L’imprimante est une imprimante distante.

Remarques

La structure Printer _ info _ 4 offre un moyen simple et extrêmement rapide de récupérer les noms des imprimantes installées sur un ordinateur local, ainsi que les connexions distantes qu’un utilisateur a établies. Quand EnumPrinters est appelé avec une structure de données Printer _ info _ 4 , cette fonction interroge le registre pour obtenir les informations spécifiées, puis retourne immédiatement. Cela diffère du comportement de EnumPrinters lorsqu’il est appelé avec d’autres niveaux de structures de données d' informations d’imprimante _ _ xxx . En particulier, quand EnumPrinters est appelé avec une structure de données de niveau 2 (Printer _ info _ 2 ), il effectue un appel OpenPrinter sur chaque connexion à distance. Si une connexion distante est interrompue, si le serveur distant n’existe plus, ou si l’imprimante distante n’existe plus, la fonction doit attendre l’expiration du délai d’attente de RPC et, par conséquent, échouer l’appel OpenPrinter . Cette opération peut prendre du temps. Le passage d’une structure Printer _ info _ 4 permet à une application de récupérer un minimum d’informations requises ; si des informations plus détaillées sont souhaitées, un appel EnumPrinter de niveau 2 suivant peut être effectué.

Les attributs peuvent également contenir des valeurs définies dans le champ attributs de Printer _ info _ 2.

certaines configurations d’imprimante, telles que les connexions d’imprimante à certains serveurs d’impression non-Windows, peuvent renvoyer à la fois un attribut d' imprimante _ _ LOCAL et un attribut d’imprimante _ _ réseau.

Configuration requise

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
_ _ Infos sur _ l’imprimante 4W (Unicode) et _ _ informations sur l’imprimante _ 4a (ANSI)

Voir aussi

Impression

Structures de l’API du spouleur d’impression

GetPrinter

EnumPrinters

OpenPrinter

_Infos sur l’imprimante _ 1

_Infos sur l’imprimante _ 2

_Infos sur l’imprimante _ 3