structure PRINTER_INFO_7

Article
06/13/2023

La structure PRINTER_INFO_7 spécifie les informations d’imprimante des services d’annuaire. Utilisez cette structure avec la fonction SetPrinter pour publier les données d’une imprimante dans le service d’annuaire (DS) ou pour mettre à jour ou supprimer les données publiées d’une imprimante de la DS. Utilisez cette structure avec la fonction GetPrinter pour déterminer si une imprimante est publiée dans la DS.

Syntaxe

typedef struct _PRINTER_INFO_7 {
  LPTSTR pszObjectGUID;
  DWORD  dwAction;
} PRINTER_INFO_7, *PPRINTER_INFO_7;

Membres

pszObjectGUID

Pointeur vers une chaîne terminée par null contenant le GUID de l’objet file d’attente d’impression du service d’annuaire associé à une imprimante publiée. Utilisez la fonction GetPrinter pour récupérer ce GUID.

Avant d’appeler SetPrinter, définissez pszObjectGUID sur NULL.

dwAction

Indique l’action que la fonction SetPrinter doit effectuer. Pour la fonction GetPrinter , ce membre indique si l’imprimante spécifiée est publiée. Ce membre peut être une combinaison des valeurs suivantes.

Valeur	Signification
DSPRINT_PENDING 0x80000000	GetPrinter : indique que le système tente d’effectuer une opération de publication ou d’annulation de publication démarrée par un appel SetPrinter . SetPrinter : cette valeur n’est pas valide.
DSPRINT_PUBLISH 0x00000001	SetPrinter : publie les données de l’imprimante dans la DS. GetPrinter : indique que l’imprimante est publiée.
DSPRINT_REPUBLISH 0x00000008	SetPrinter : les données DS de l’imprimante ne sont pas publiées, puis publiées à nouveau, ce qui actualise toutes les propriétés de l’imprimante publiée. La rééditation modifie également le GUID de l’imprimante publiée. GetPrinter : ne retourne jamais cette valeur.
DSPRINT_UNPUBLISH 0x00000004	SetPrinter : supprime les données publiées de l’imprimante de la DS. GetPrinter : indique que l’imprimante n’est pas publiée.
DSPRINT_UPDATE 0x00000002	SetPrinter : Mises à jour les données publiées de l’imprimante dans la DS. GetPrinter : ne retourne jamais cette valeur.

Notes

La structure PRINTER_INFO_7 est utilisée dans un appel SetPrinter pour publier des informations d’imprimante sur le service d’annuaire. Les données publiées incluent toutes les valeurs et données de l’imprimante spécifiée sous les clés SPLDS_SPOOLER_KEY, SPLDS_DRIVER_KEY ou SPLDS_USER_KEY créées par SetPrinterDataEx.

Pour SetPrinter, pszObjectGUID doit avoir la valeur NULL. Pour GetPrinter, pszObjectGUID retourne le GUID de l’objet file d’attente d’impression des services d’annuaires associé à une imprimante publiée. Vous pouvez utiliser ce GUID avec les méthodes ADSI (Active Directory Services Interface) pour récupérer les données publiées pour l’imprimante. Toutefois, la méthode recommandée pour récupérer des données publiées consiste à appeler la fonction GetPrinterDataEx .

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	_PRINTER_INFO_7W (Unicode) et _PRINTER_INFO_7A (ANSI)

Voir aussi

Impression
Structures de l’API spouleur d’impression

Partager via