DRIVER_UPGRADE_INFO_2-Struktur (winddiui.h)

Die DRIVER_UPGRADE_INFO_2-Struktur wird als Eingabe für die DrvUpgradePrinter-Funktion einer Druckerschnittstellen-DLL verwendet.

Syntax

typedef struct _DRIVER_UPGRADE_INFO_2 {
  LPTSTR pPrinterName;
  LPTSTR pOldDriverDirectory;
  DWORD  cVersion;
  LPTSTR pName;
  LPTSTR pEnvironment;
  LPTSTR pDriverPath;
  LPTSTR pDataFile;
  LPTSTR pConfigFile;
  LPTSTR pHelpFile;
  LPTSTR pDependentFiles;
  LPTSTR pMonitorName;
  LPTSTR pDefaultDataType;
  LPTSTR pszzPreviousNames;
} DRIVER_UPGRADE_INFO_2, *PDRIVER_UPGRADE_INFO_2;

Member

pPrinterName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Druckers angibt. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

pOldDriverDirectory

Zeiger auf eine NULL-beendete Zeichenfolge, die das lokale Verzeichnis angibt, in dem die alten Druckertreiberdateien gefunden werden können.

cVersion

Gibt die Betriebssystemversion an, für die der Treiber geschrieben wurde.

Wert	Betriebssystem
0	Windows 95/98/Me
1	Windows NT 3.1 bis Windows NT 3.51
2	Windows NT 4.0
3	Windows 2000 und höher

pName

Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen des Treibers angibt (z. B. "QMS 810"). Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

pEnvironment

Zeiger auf eine NULL-beendete Zeichenfolge, die die Umgebung angibt, für die der Treiber geschrieben wurde (z. B. "Windows NT x86" oder "Windows Itanium").

pDriverPath

Zeiger auf eine NULL-beendete Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Datei angibt, die den Gerätetreiber enthält (z. B. "pscript.dll").

pDataFile

Zeiger auf eine NULL-beendete Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Datei angibt, die Treiberdaten enthält (z. B. "qms810.ppd").

pConfigFile

Zeiger auf eine NULL-endende Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Konfigurationsbibliothek für dynamische Verknüpfungen des Gerätetreibers angibt (z. B. "pscrptui.dll").

pHelpFile

Zeiger auf eine NULL-endende Zeichenfolge, die einen Dateinamen oder einen vollständigen Pfad und Dateinamen für die Hilfedatei des Gerätetreibers angibt.

pDependentFiles

Zeiger auf eine NULL-beendete Zeichenfolge, die die Dateien angibt, von denen der Treiber abhängt. Jeder Dateiname in der Zeichenfolge wird ebenfalls mit einem NULL-Zeichen beendet (z. B. "pscript.dll\0qms810.ppd\0pscrptui.dll\0pscrptui.hlp\0pstest.txt\0\0").

pMonitorName

Zeiger auf eine NULL-beendete Zeichenfolge, die einen Sprachmonitor angibt (z. B. "PJL-Monitor"). Dieser Member kann NULL sein und sollte nur für Drucker angegeben werden, die bidirektional kommunizieren können.

pDefaultDataType

Zeiger auf eine NULL-beendete Zeichenfolge, die den Standarddatentyp des Druckauftrags angibt (z. B. "EMF").

pszzPreviousNames

Zeiger auf eine NULL-beendete Zeichenfolge, die alle vorherigen Druckertreibernamen angibt, die mit diesem Treiber kompatibel sind (z. B. "OldName1\0OldName2\0\0").

Hinweise

Wenn DrvUpgradePrinter mit dem pDriverUpgradeInfo-Parameter aufgerufen wird, der auf eine DRIVER_UPGRADE_INFO_2-Struktur zeigt, zeigt der pPrinterName-Member auf eine Zeichenfolge, die den Namen des zu aktualisierenden Druckers enthält. Das pName-Element verweist auf eine Zeichenfolge, die den Namen des zu aktualisierenden Druckertreibers enthält. Dabei handelt es sich nicht unbedingt um den Treiber für den Drucker, auf dessen Name das pPrinterName-Element verweist.

Um zu sehen, wie dies geschehen kann, nehmen Sie an, dass ein Computer mit zwei Druckern verbunden ist, deren Treiber "Acme Plotter" heißt und der andere, dessen Treiber "Acme RasterMaster" heißt. Nehmen wir auch an, dass beide Treiber eine gemeinsame Treiberdatei plotui.dll. Wenn der Treiber "Acme Plotter" durch einen Aufruf der AddPrinterDriverEx-Funktion aktualisiert wird (beschrieben in der Microsoft Windows SDK-Dokumentation), wird DrvUpgradePrinter für beide Drucker aufgerufen, da beide Treiber Dateien verwenden, die vom Upgrade betroffen sind. In beiden Aufrufen zeigt das pName-Element auf "Acme Plotter", den Namen des Druckertreibers, der im Aufruf von AddPrinterDriverEx verwendet wurde. Die Zeichenfolge, auf die das pPrinterName-Element verweist, unterscheidet sich jedoch in beiden Aufrufen von DrvUpgradePrinter. Bei jedem Aufruf zeigt pPrinterName auf den Namen des Druckers, der aktualisiert wird.

Anforderungen

Anforderung	Wert
Header	winddiui.h (einschließlich Winddiui.h)

Weitere Informationen

DRIVER_UPGRADE_INFO_1

DrvUpgradePrinter