structure PRINTER_INFO_7

  • Article

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