IPrintCoreUI2::DrvUpgradeRegistrySetting method (prcomoem.h)

The IPrintCoreUI2::DrvUpgradeRegistrySetting method is provided by the Windows XP Pscript5 driver so that Pscript5 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

This method is inherited from the IPrintOemDriverUI COM Interface, which includes a DrvUpgradeRegistrySetting method. The behavior of this method is exactly the same as that of IPrintOemDriverUI::DrvUpgradeRegistrySetting.

This method should be called only by the OEM's IPrintOemUI::UpgradePrinter method.

Requirements

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

See also

IPrintCoreUI2

IPrintOemDriverUI::DrvUpgradeRegistrySetting