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
Winspool.h (include Windows.h)
Bibliothek
Winspool.lib
DLL
Winspool.drv
Unicode- und ANSI-Name
DeletePrinterDataW (Unicode) und DeletePrinterDataA (ANSI)

Siehe auch

Drucken

Druckspooler-API-Funktionen

EnumPrinterData

GetPrinterData

OpenPrinter

SetPrinter

SetPrinterData