InstallPrinterDriverFromPackage-Funktion

Artikel
06/12/2023

Installiert einen Druckertreiber aus einem Treiberpaket, das sich im Treiberspeicher des Druckservers 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, NULL-endende Zeichenfolge, die den Namen des Druckservers angibt. NULL bedeutet den lokalen Computer.
pszInfPath [in]: Ein Zeiger auf eine konstante, NULL-endende Zeichenfolge, die den Treiberspeicherpfad zur INF-Datei des Drucktreibers angibt. NULL bedeutet, dass sich der Treiber in einer inf-Datei befindet, die im Lieferumfang von Windows enthalten ist.
pszDriverName [in]: Ein Zeiger auf eine konstante, NULL-endende Zeichenfolge, die den Namen des Treibers angibt.
pszEnvironment [in]: Ein Zeiger auf eine konstante, NULL-endende 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 kopiert werden müssen, die neuer sind als die aktuell verwendeten Dateien. Der Wert IPDFP_COPY_ALL_FILES bedeutet, dass der Druckertreiber und alle Dateien im Druckertreiberverzeichnis hinzugefügt werden müssen. Die Zeitstempel der Datei werden ignoriert, wenn dwFlags den Wert IPDFP_COPY_ALL_FILES hat.

Rückgabewert

Wenn der Vorgang erfolgreich ist, wird 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ückgegeben wird. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierungsfaktoren 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 führen, dass die Anwendung nicht mehr reagiert.

Der Treiberspeicher ist in der Regel %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 Terminaldiensten angemeldet ist.

Auf einem Remotecomputer können nur signierte Pakete installiert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Winspool.h (Einschließen von Windows.h)
Bibliothek	Winspool.lib
DLL	Spoolss.dll
Unicode- und ANSI-Name	InstallPrinterDriverFromPackageW (Unicode) und InstallPrinterDriverFromPackageA (ANSI)

Siehe auch

Drucken
Druckspooler-API-Funktionen

Freigeben über