DeletePrinterDataEx-Funktion
Die DeletePrinterDataEx-Funktion löscht einen angegebenen Wert aus den Konfigurationsdaten für einen Drucker. Die Konfigurationsdaten eines Druckers bestehen aus einem Satz benannter und typisierter Werte, die in einer Hierarchie von Registrierungsschlüsseln gespeichert sind. Die Funktion löscht einen angegebenen Wert unter einem angegebenen Schlüssel.
Wie die DeletePrinterData-Funktion kann DeletePrinterDataEx werte löschen, die von der SetPrinterData-Funktion gespeichert sind. Darüber hinaus kann DeletePrinterDataEx Werte löschen, die unter einem angegebenen Schlüssel von der SetPrinterDataEx-Funktion gespeichert sind.
Syntax
DWORD DeletePrinterDataEx(
_In_ HANDLE hPrinter,
_In_ LPCTSTR pKeyName,
_In_ LPCTSTR pValueName
);
Parameter
-
hPrinter [in]
-
Ein Handle für den Drucker, für den die Funktion einen Wert löscht. Verwenden Sie die OpenPrinter - oder AddPrinter-Funktion , um einen Druckerhandle abzurufen.
-
pKeyName [in]
-
Ein Zeiger auf eine NULL-Zeichenfolge, die den Schlüssel mit dem zu löschenden Wert angibt. Verwenden Sie den umgekehrten Schrägstrich ( \ ) als Trennzeichen, um einen Pfad anzugeben, der mindestens einen Unterschlüssel enthält.
Wenn pKeyNameNULL oder eine leere Zeichenfolge ist, gibt DeletePrinterDataEx ERROR_INVALID_PARAMETER zurück.
-
pValueName [in]
-
Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des zu löschenden Werts angibt.
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 |
DeletePrinterDataExW (Unicode) und DeletePrinterDataExA (ANSI) |