Metode IPrintOemUI::UpgradePrinter (prcomoem.h)

  • Artikel

Metode ini IPrintOemUI::UpgradePrinter memungkinkan plug-in antarmuka pengguna untuk meningkatkan nilai opsi perangkat yang disimpan di registri.

Sintaks

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

Parameter

dwLevel

Nomor versi yang disediakan penelepon dari struktur yang ditunjukkan oleh pDriverUpgradeInfo. Nilai yang valid saat ini adalah 1.

pDriverUpgradeInfo

Penunjuk yang disediakan penelepon ke struktur DRIVER_UPGRADE_INFO_1 .

Nilai kembali

Metode harus mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Operasi berhasil.
E_FAIL
 Operasi gagal.
E_NOTIMPL
 Metode ini tidak diterapkan.

Keterangan

Jika Anda menyediakan plug-in antarmuka pengguna untuk salah satu driver printer Microsoft, dan jika plug-in antarmuka pengguna menyimpan nilai opsi perangkat di registri, itu harus menerapkan metode untuk memperbarui nilai-nilai tersebut IPrintOemUI::UpgradePrinter .

Metode plug-in antarmuka pengguna melakukan jenis operasi yang sama dengan fungsi DrvUpgradePrinter yang diekspor IPrintOemUI::UpgradePrinter oleh DLL antarmuka printer mode pengguna. Ketika fungsi DrvUpgradePrinter driver dipanggil, fungsi ini memperbarui nilai registrinya IPrintOemUI::UpgradePrinter sendiri dan kemudian memanggil metode .

Jika IPrintOemUI::UpgradePrinter metode diekspor oleh beberapa plug-in antarmuka pengguna, metode dipanggil dalam urutan plug-in ditentukan untuk penginstalan.

Untuk informasi selengkapnya tentang membuat dan menginstal plug-in antarmuka pengguna, lihat Menyesuaikan Driver Printer Microsoft.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header prcomoem.h (termasuk Prcomoem.h)