DeletePrinterData-Funktion
Die DeletePrinterData-Funktion löscht die angegebenen Konfigurationsdaten für einen Drucker. Die Konfigurationsdaten eines Druckers bestehen aus einem Satz von benannten und typierten Werten. Die DeletePrinterData-Funktion löscht einen dieser Werte, der durch ihren Wertnamen angegeben wird.
Das Aufrufen von DeletePrinterData entspricht dem Aufrufen der DeletePrinterDataEx-Funktion, bei der der pKeyName-Parameter auf "PrinterDriverData" festgelegt ist.
Syntax
DWORD DeletePrinterData(
_In_ HANDLE hPrinter,
_In_ LPTSTR pValueName
);
Parameter
-
hPrinter [ In]
-
Ein Handle für den Drucker, dessen Konfigurationsdaten gelöscht werden sollen. Verwenden Sie die OpenPrinter- oder AddPrinter-Funktion, um einen Druckerhandpunkt abzurufen.
-
pValueName [ In]
-
Ein Zeiger auf den auf NULL beendeten Namen des zu löschenden Konfigurationsdatenwerts.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR _ SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.
Hinweise
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.
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 |
DeletePrinterDataW (Unicode) und DeletePrinterDataA (ANSI) |