AddPrinterDriver-Funktion
Die AddPrinterDriver-Funktion installiert einen lokalen oder Remotedruckertreiber und ordnet die Konfigurations-, Daten- und Treiberdateien zu.
Um mehr Flexibilität beim Installieren oder Aktualisieren von Druckertreibern zu erhalten, verwenden Sie die AddPrinterDriverEx-Funktion, da sie strenge Upgrades, strenge Downgrades, nur das Kopieren neuerer Dateien und das Kopieren aller Dateien (unabhängig von den Dateizeitstempeln) ermöglicht.
Hinweis
Das Installieren eines Druckertreibers ohne Treiberpaket wird nicht mehr empfohlen. Verwenden Sie stattdessen InstallPrinterDriverFromPackage.
Syntax
BOOL AddPrinterDriver(
_In_ LPTSTR pName,
_In_ DWORD Level,
_In_ LPBYTE pDriverInfo
);
Parameter
-
pName [ In]
-
Ein Zeiger auf eine auf NULL beendete Zeichenfolge, die den Namen des Servers angibt, auf dem der Treiber installiert werden soll.
Wenn pName NULL ist, wird der Treiber lokal installiert.
-
Ebene [ In]
-
Die Version der -Struktur, auf die pDriverInfo verweist.
Dieser Wert kann 2, 3, 4, 6 oder 8 sein.
-
pDriverInfo [ In]
-
Ein Zeiger auf eine -Struktur, die Druckertreiberinformationen enthält. Dies hängt vom Wert der Ebene ab.
Wert Druckerlaufwerkstruktur 2 TREIBERINFORMATIONEN _ _ 2 3 TREIBERINFORMATIONEN _ _ 3 4 TREIBERINFORMATIONEN _ _ 4 6 TREIBERINFORMATIONEN _ _ 6 8 TREIBERINFORMATIONEN _ _ 8 Wenn der pEnvironment-Member der Struktur, auf die pDriverInfo zeigt, NULL ist, wird die aktuelle Umgebung des Aufrufers/Clients (nicht des Ziels/Servers) verwendet.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich 0 (null).
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Bemerkungen
Hinweis
Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückkehrt. Wie schnell diese Funktion zurückgegeben wird, hängt von Laufzeitfaktoren wie Netzwerkstatus, Druckerserverkonfiguration und Implementierungsfaktoren des Druckertreibers ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu kommen, dass die Anwendung nicht reagiert.
Der Aufrufer muss über seLoadDriverPrivilege verfügen.
Bevor eine Anwendung die AddPrinterDriver-Funktion aufruft, müssen alle vom Treiber benötigten Dateien in das Druckertreiberverzeichnis des Systems kopiert werden. Eine Anwendung kann den Namen dieses Verzeichnisses abrufen, indem sie die GetPrinterDriverDirectory-Funktion aufruft.
Eine Anwendung kann ermitteln, welche Druckertreiber derzeit installiert sind, indem sie die EnumPrinterDrivers-Funktion aufruft.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
AddPrinterDriverW (Unicode) und AddPrinterDriverA (ANSI) |