共用方式為

IPrintOemUI：：UpgradePrinter 方法 （prcomoem.h）

  • 發行項

IPrintOemUI::UpgradePrinter 方法可讓使用者介面外掛程式升級儲存在登錄中的裝置選項值。

語法

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

參數

dwLevel

pDriverUpgradeInfo 所指向之結構的呼叫端提供版本號碼，。 目前的有效值為 1。

pDriverUpgradeInfo

呼叫端提供的 DRIVER_UPGRADE_INFO_1 結構的指標。

傳回值

方法必須傳回下列其中一個值。

傳回碼 描述
S_OK
 作業成功。
E_FAIL
 作業失敗。
E_NOTIMPL
 未實作 方法。

言論

如果您為其中一個Microsoft印表機驅動程式提供使用者介面外掛程式，而且使用者介面外掛程式會將裝置選項值儲存在登錄中，則應該實作 IPrintOemUI::UpgradePrinter 方法來更新這些值。

使用者介面外掛程式的 IPrintOemUI::UpgradePrinter 方法會執行與使用者模式印表機介面 DLL 所匯出之 DrvUpgradePrinter 函式相同的作業類型。 呼叫驅動程式的 DrvUpgradePrinter 函式時，它會更新自己的登錄值，然後呼叫 IPrintOemUI::UpgradePrinter 方法。

如果 IPrintOemUI::UpgradePrinter 多個使用者介面外掛程式匯出方法，則會依外掛程式指定安裝的順序呼叫方法。

如需建立及安裝使用者介面外掛程式的詳細資訊，請參閱 自定義Microsoft的印表機驅動程式。

要求

要求 價值
目標平臺 桌面
標頭 prcomoem.h （include Prcomoem.h）