DeletePrinterData-Funktion
Die DeletePrinterData-Funktion löscht die angegebenen Konfigurationsdaten für einen Drucker. Die Konfigurationsdaten eines Druckers bestehen aus einem Satz benannter und typisierter Werte. Die DeletePrinterData-Funktion löscht einen dieser Werte, die durch den Wertnamen angegeben werden.
Das Aufrufen von DeletePrinterData entspricht dem Aufrufen der DeletePrinterDataEx-Funktion , wobei 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 Druckerhandle abzurufen.
-
pValueName [in]
-
Ein Zeiger auf den null-beendeten Namen des zu löschenden Konfigurationsdatenwerts.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.
Bemerkungen
Hinweis
Dies ist eine blockierende oder synchrone Funktion und wird möglicherweise nicht sofort zurückgegeben. 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. Wenn Sie diese Funktion über einen Thread aufrufen, der die Interaktion mit der Benutzeroberfläche verwaltet, kann die Anwendung nicht reagieren.
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) |