InstallPrinterDriverFromPackage-Funktion
Installiert einen Druckertreiber aus einem Treiberpaket, das sich im Treiberspeicher des Druckerservers befindet.
Syntax
HRESULT InstallPrinterDriverFromPackage(
_In_ LPCTSTR pszServer,
_In_ LPCTSTR pszInfPath,
_In_ LPCTSTR pszDriverName,
_In_ LPCTSTR pszEnvironment,
_In_ DWORD dwFlags
);
Parameter
-
pszServer [ In]
-
Ein Zeiger auf eine konstante, mit NULL beendete Zeichenfolge, die den Namen des Druckerservers angibt. NULL bedeutet den lokalen Computer.
-
pszInfPath [ In]
-
Ein Zeiger auf eine konstante, mit NULL beendete Zeichenfolge, die den Treiberspeicherpfad zur INF-Datei des Druckertreibers angibt. NULL bedeutet, dass sich der Treiber in einer inf-Datei befindet, die im Lieferumfang Windows.
-
pszDriverName [ In]
-
Ein Zeiger auf eine konstante, mit NULL beendete Zeichenfolge, die den Namen des Treibers angibt.
-
pszEnvironment [ In]
-
Ein Zeiger auf eine konstante, mit NULL beendete Zeichenfolge, die die Prozessorarchitektur angibt (z. B. Windows NT x86). Dies kann NULL sein.
-
dwFlags [ In]
-
Dies kann nur 0 oder IPDFP _ COPY _ ALL FILES _ sein. Der Wert 0 bedeutet, dass der Druckertreiber hinzugefügt und alle Dateien im Druckertreiberverzeichnis, die neuer als die entsprechenden derzeit in Gebrauch sind, kopiert werden müssen. Der Wert IPDFP COPY ALL FILES bedeutet, dass der Druckertreiber und alle Dateien im Druckertreiberverzeichnis _ _ hinzugefügt werden _ müssen. Die Dateizeitstempel werden ignoriert, wenn dwFlags über den Wert IPDFP _ COPY ALL FILES _ _ verfügt.
Rückgabewert
Wenn der Vorgang erfolgreich ist, ist der Rückgabewert S _ OK, andernfalls enthält das HRESULT einen Fehlercode.
Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung.
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 Treiberspeicher ist in der Regel entweder %windir% \ inf oder %windir% \ System32 \ DriverStore \ FileRepository.
InstallPrinterDriverFromPackage installiert auch andere Dateien im Paket, z. B. Farbprofile und Druckprozessoren.
Benutzer müssen über Druckerverwaltungsrechte verfügen, um entweder auf einem Remotecomputer oder auf dem lokalen Computer zu installieren, wenn der Benutzer bei den Terminaldiensten angemeldet ist.
Nur signierte Pakete können auf einem Remotecomputer installiert werden.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
InstallPrinterDriverFromPackageW (Unicode) und InstallPrinterDriverFromPackageA (ANSI) |