DeletePrinterDriverPackage-Funktion

Artikel
06/12/2023

Löscht ein Druckertreiberpaket aus dem Treiberspeicher.

Syntax

HRESULT DeletePrinterDriverPackage(
  _In_ LPCTSTR pszServer,
  _In_ LPCTSTR pszInfPath,
  _In_ LPCTSTR pszEnvironment
);

Parameter

pszServer [in]: Ein Zeiger auf eine konstante, NULL-endende Zeichenfolge, die den Namen des Druckservers angibt, von dem das Treiberpaket gelöscht wird. Ein NULL-Zeigerwert bedeutet den lokalen Computer.
pszInfPath [in]: Ein Zeiger auf eine konstante, NULL-endende Zeichenfolge, die den Pfad zur *.inf-Datei 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.

Rückgabewert

S_OK, wenn der Vorgang erfolgreich ist.

E_ACCESSDENIED, wenn das Paket mit Windows ausgeliefert wurde.

HRESULT_CODE(ERROR_PRINT_DRIVER_PACKAGE_IN_USE), wenn das Paket verwendet wird.

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.

Ein Treiberpaket, das im Lieferumfang von Windows enthalten ist, kann mit dieser Funktion nicht entfernt werden.

Der Benutzer muss über Druckerverwaltungsberechtigungen verfügen.

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	DeletePrinterDriverPackageW (Unicode) und DeletePrinterDriverPackageA (ANSI)

Siehe auch

Drucken
Druckspooler-API-Funktionen

Freigeben über