Edit

IPrintOemDriverUI::DrvUpgradeRegistrySetting method (prcomoem.h)

  • Article

The IPrintOemDriverUI::DrvUpdateRegistrySetting method is provided by the Unidrv and Pscript5 minidrivers so that user interface plug-ins can update device settings stored in the registry.

Syntax

HRESULT DrvUpgradeRegistrySetting(
  HANDLE hPrinter,
  PCSTR  pFeature,
  PCSTR  pOption
);

Parameters

hPrinter

Caller-supplied printer handle.

pFeature

Caller-supplied pointer to a string identifying a printer feature name contained in the printer's GPD or PPD file.

pOption

Caller-supplied pointer to a string identifying an option name, associated with the specified feature, contained in the printer's GPD or PPD file.

Return value

The method must return one of the following values.

Return code Description
S_OK
 The operation succeeded.
E_FAIL
 The operation failed.
E_NOTIMPL
 The method is not implemented.

Remarks

The IPrintOemDriverUI::DrvUpdateRegistrySetting method is meant to be called from a user interface plug-in's IPrintOemUI::UpgradePrinter method, when it is necessary to update registry settings that were stored in private registry keys for an earlier version of the driver, but are now contained in a GPD or PPD file.

Requirements

Requirement Value
Target Platform Desktop
Header prcomoem.h (include Prcomoem.h)