DeletePrinterData

The DeletePrinterData function deletes specified configuration data for a printer.

A printer's configuration data consists of a set of named and typed values. The DeletePrinterData function deletes one of these values, specified by its value name.

DWORD DeletePrinterData(
  HANDLE hPrinter,  // handle to printer of interest
  LPTSTR pValueName
                    // pointer to null-terminated value name string
);
 

Parameters

hPrinter

Handle to the printer whose configuration data is to be deleted.

You obtain this printer handle by calling the OpenPrinter function.

pValueName

Pointer to the null-terminated name of the configuration data value to be deleted.

Return Values

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is a Win32 error value.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winspool.h.
  Import Library: Use winspool.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Printing and Print Spooler Overview, Printing and Print Spooler Functions, EnumPrinterData, GetPrinterData, OpenPrinter, SetPrinter, SetPrinterData