DeletePrinterDriver-Funktion
Die DeletePrinterDriver-Funktion entfernt den angegebenen Druckertreibernamen aus der Liste der namen der unterstützten Treiber auf einem Server.
Verwenden Sie die DeletePrinterDriverEx-Funktion , um die dem Treiber zugeordneten Dateien zusätzlich zum Entfernen des angegebenen Druckertreibernamens aus der Liste der unterstützten Treiber für einen Server zu löschen.
DeletePrinterDriver löscht einen Treiber nur, wenn keine Version des Treibers für die angegebene Umgebung verwendet wird. DeletePrinterDriverEx kann bestimmte Versionen des Treibers löschen.
Syntax
BOOL DeletePrinterDriver(
_In_ LPTSTR pName,
_In_ LPTSTR pEnvironment,
_In_ LPTSTR pDriverName
);
Parameter
-
pName [in]
-
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Servers angibt, von dem der Treiber gelöscht werden soll. Wenn dieser Parameter NULL ist, wird der Name des Druckertreibers lokal entfernt.
-
pEnvironment [in]
-
Ein Zeiger auf eine NULL-endende Zeichenfolge, die die Umgebung angibt, aus der der Treiber gelöscht werden soll (z. B. Windows x86, Windows IA64 oder Windows x64). Wenn dieser Parameter NULL ist, wird der Treibername aus der aktuellen Umgebung der aufrufenden Anwendung und des Clientcomputers (nicht der Zielanwendung und des Druckservers) gelöscht.
-
pDriverName [in]
-
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Treibers angibt, der gelöscht werden soll.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich 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ü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 Aufrufer muss über das SeLoadDriverPrivilege verfügen.
Die DeletePrinterDriver-Funktion löscht die zugeordneten Dateien nicht, sondern entfernt lediglich den Treibernamen aus der Liste, die von der EnumPrinterDrivers-Funktion zurückgegeben wird.
Vor dem Aufrufen von DeletePrinterDriver müssen Sie alle Druckerobjekte löschen, die den Druckertreiber verwenden.
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 |
DeletePrinterDriverW (Unicode) und DeletePrinterDriverA (ANSI) |