次の方法で共有

DrvUpgradePrinter 関数 (winddiui.h)

  • [アーティクル]

プリンター インターフェイス DLL の DrvUpgradePrinter 関数は、新しいバージョンのドライバーがシステムに追加されたときにプリンターのレジストリ設定を更新するために使用されます。

構文

BOOL DrvUpgradePrinter(
                 DWORD  Level,
  [in, optional] LPBYTE pDriverUpgradeInfo
);

パラメーター

Level

次の表に示すように、pDriverUpgradeInfo 指す構造体の種類を示す呼び出し元指定の値。

レベルの 値 pDriverUpgradeInfo 指す構造体
1 DRIVER_UPGRADE_INFO_1
2 DRIVER_UPGRADE_INFO_2

[in, optional] pDriverUpgradeInfo

dwLevel によって型が識別される構造体呼び出し元が指定したポインター。

戻り値

操作が成功した場合、関数は TRUE 返す必要があります。それ以外の場合は、SetLastError を呼び出してエラー コードを設定し、FALSE 返す必要があります。

備考

プリンター インターフェイス DLL は、必要に応じて、DrvUpgradePrinter 関数を提供できます。 その場合、スプーラーは、プリンター ドライバーがシステムにコピーされるときに、すべてのプリンターに対してそれを呼び出します。 これは、オペレーティング システムのリリースから次のリリースにシステムがアップグレードされたとき、またはアプリケーションが Win32 AddPrinterDriver 関数を呼び出してプリンター ドライバーを更新するときに発生します。

多くの場合、新しいバージョンのドライバーには、以前のバージョンとは異なるレジストリ設定が必要です。 DrvUpgradePrinter 関数の目的は、ドライバーと互換性のあるレジストリを更新することです。 レジストリにプリンター情報を格納する方法の詳細については、「DrvPrinterEventを参照してください。

Windows 2000 以降では、スプーラーが DrvUpgradePrinter 呼び出すと、pDriverUpgradeInfo のDRIVER_UPGRADE_INFO_2構造体ポインターが提供されます。 関数が FALSE 返す場合、スプーラーは関数を再度呼び出します。今回は、DRIVER_UPGRADE_INFO_1構造体ポインターを指定します。 この呼び出しで FALSE 返された場合、スプーラーはイベント ログにエントリを書き込みます。

Windows NT 4.0 以前の場合、スプーラーは DrvUpgradePrinter 呼び出すときに、pDriverUpgradeInfo DRIVER_UPGRADE_INFO_1構造体ポインターを提供します。 関数から FALSE 返された場合、スプーラーはイベント ログにエントリを書き込みます。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー winddiui.h (Winddiui.h を含む)

関連項目

DRIVER_UPGRADE_INFO_1

DRIVER_UPGRADE_INFO_2

DrvPrinterEvent