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 のプリンター ドライバーの 1 つにユーザー インターフェイス プラグインを指定し、ユーザー インターフェイス プラグインがデバイス オプションの値をレジストリに格納する場合は、 メソッドを IPrintOemUI::UpgradePrinter 実装してこれらの値を更新する必要があります。

ユーザー インターフェイス プラグインの IPrintOemUI::UpgradePrinter メソッドは、ユーザー モード プリンター インターフェイス DLL によってエクスポートされる DrvUpgradePrinter 関数と同じ種類の操作を実行します。 ドライバーの DrvUpgradePrinter 関数が呼び出されると、独自のレジストリ値が更新され、 メソッドが IPrintOemUI::UpgradePrinter 呼び出されます。

メソッドが複数のユーザー インターフェイス プラグインによってエクスポートされる場合 IPrintOemUI::UpgradePrinter 、インストール用にプラグインを指定した順序でメソッドが呼び出されます。

ユーザー インターフェイス プラグインの作成とインストールの詳細については、「 Microsoft のプリンター ドライバーのカスタマイズ」を参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header prcomoem.h (Prcomoem.h を含む)