Freigeben über


PRINTER_INFO_7 Struktur

Die PRINTER_INFO_7-Struktur gibt Die Druckerinformationen für Verzeichnisdienste an. Verwenden Sie diese Struktur mit der SetPrinter-Funktion , um die Daten eines Druckers im Verzeichnisdienst (Directory Service, DS) zu veröffentlichen oder die veröffentlichten Daten eines Druckers zu aktualisieren oder aus dem DS zu entfernen. Verwenden Sie diese Struktur mit der GetPrinter-Funktion , um zu bestimmen, ob ein Drucker im DS veröffentlicht wird.

Syntax

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

Member

pszObjectGUID

Ein Zeiger auf eine null-beendete Zeichenfolge, die die GUID des Verzeichnisdienst-Druckwarteschlangenobjekts enthält, das einem veröffentlichten Drucker zugeordnet ist. Verwenden Sie die GetPrinter-Funktion , um diese GUID abzurufen.

Legen Sie vor dem Aufrufen von SetPrinterpszObjectGUID auf NULL fest.

dwAction

Gibt die Aktion an, die für die SetPrinter-Funktion ausgeführt werden soll. Für die GetPrinter-Funktion gibt dieses Element an, ob der angegebene Drucker veröffentlicht wird. Dieser Member kann eine Kombination der folgenden Werte sein.

Wert Bedeutung
DSPRINT_PENDING
0x80000000
GetPrinter: Gibt an, dass das System versucht, einen Veröffentlichungs- oder Veröffentlichungsvorgang abzuschließen, der durch einen SetPrinter-Aufruf gestartet wurde.
SetPrinter: Dieser Wert ist ungültig.
DSPRINT_PUBLISH
0x00000001
SetPrinter: Veröffentlicht die Daten des Druckers im DS.
GetPrinter: Gibt an, dass der Drucker veröffentlicht wird.
DSPRINT_REPUBLISH
0x00000008
SetPrinter: Die DS-Daten für den Drucker werden nicht veröffentlicht und dann erneut veröffentlicht, wobei alle Eigenschaften im veröffentlichten Drucker aktualisiert werden. Die erneute Veröffentlichung ändert auch die GUID des veröffentlichten Druckers.
GetPrinter: Gibt diesen Wert nie zurück.
DSPRINT_UNPUBLISH
0x00000004
SetPrinter: Entfernt die veröffentlichten Daten des Druckers aus dem DS.
GetPrinter: Gibt an, dass der Drucker nicht veröffentlicht wurde.
DSPRINT_UPDATE
0x00000002
SetPrinter: Updates die veröffentlichten Daten des Druckers im DS.
GetPrinter: Gibt diesen Wert nie zurück.

Bemerkungen

Die PRINTER_INFO_7-Struktur wird in einem SetPrinter-Aufruf verwendet, um Druckerinformationen im Verzeichnisdienst zu veröffentlichen. Die veröffentlichten Daten enthalten alle Werte und Daten für den angegebenen Drucker, die sich unter dem SPLDS_SPOOLER_KEY, SPLDS_DRIVER_KEY oder SPLDS_USER_KEY Schlüsseln befinden, die von SetPrinterDataEx erstellt wurden.

Für SetPrinter sollte pszObjectGUID auf NULL festgelegt werden. Für GetPrinter gibt pszObjectGUID die GUID des Verzeichnisdienste-Druckwarteschlangenobjekts zurück, das einem veröffentlichten Drucker zugeordnet ist. Sie können diese GUID mit ADSI-Methoden (Active Directory Services Interface) verwenden, um veröffentlichte Daten für den Drucker abzurufen. Die empfohlene Methode zum Abrufen veröffentlichter Daten besteht jedoch darin, die GetPrinterDataEx-Funktion aufzurufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Winspool.h (einschließlich Windows.h)
Unicode- und ANSI-Name
_PRINTER_INFO_7W (Unicode) und _PRINTER_INFO_7A (ANSI)

Siehe auch

Drucken

Drucken von Spooler-API-Strukturen