PRINTER_INFO_7 Struktur

Artikel
06/13/2023

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