Fungsi DrvUpgradePrinter (winddiui.h)
Fungsi DrvUpgradePrinter antarmuka pencetak digunakan untuk memperbarui pengaturan registri printer ketika versi baru driver ditambahkan ke sistem.
Sintaks
BOOL DrvUpgradePrinter(
DWORD Level,
[in, optional] LPBYTE pDriverUpgradeInfo
);
Parameter
Level
Nilai yang disediakan penelepon menunjukkan jenis struktur yang ditunjukkan oleh pDriverUpgradeInfo, seperti yang ditunjukkan dalam tabel berikut ini.
| Nilai tingkat | Struktur yang ditunjukkan oleh pDriverUpgradeInfo |
|---|---|
| 1 | DRIVER_UPGRADE_INFO_1 |
| 2 | DRIVER_UPGRADE_INFO_2 |
[in, optional] pDriverUpgradeInfo
Penunjuk yang disediakan penelepon ke struktur yang jenisnya diidentifikasi oleh dwLevel.
Nilai kembali
Jika operasi berhasil, fungsi harus mengembalikan TRUE; jika tidak, ia harus memanggil SetLastError untuk mengatur kode kesalahan dan mengembalikan FALSE.
Keterangan
DLL antarmuka printer dapat secara opsional menyediakan fungsi DrvUpgradePrinter. Jika ya, penampung memanggilnya untuk setiap pencetak ketika pengandar pencetak disalin ke sistem. Ini terjadi ketika sistem ditingkatkan dari satu rilis sistem operasi ke rilis berikutnya, atau ketika aplikasi memperbarui driver printer dengan memanggil fungsi Win32 AddPrinterDriver .
Seringkali, versi driver baru memerlukan pengaturan registri yang berbeda dari versi lama. Tujuan fungsi DrvUpgradePrinter adalah untuk memperbarui registri sehingga kompatibel dengan driver. Untuk informasi selengkapnya tentang menyimpan informasi printer di registri, lihat DrvPrinterEvent.
Untuk Windows 2000 dan yang lebih baru, ketika penampung memanggil DrvUpgradePrinter, ia menyediakan penunjuk struktur DRIVER_UPGRADE_INFO_2 untuk pDriverUpgradeInfo. Jika fungsi mengembalikan FALSE, penampung memanggil fungsi lagi, kali ini menentukan penunjuk struktur DRIVER_UPGRADE_INFO_1. Jika panggilan ini mengembalikan FALSE, penampung menulis entri di log peristiwa.
Untuk Windows NT 4.0 dan yang sebelumnya, ketika penampung memanggil DrvUpgradePrinter, penunjuk struktur DRIVER_UPGRADE_INFO_1 untuk pDriverUpgradeInfo. Jika fungsi mengembalikan FALSE, penampung menulis entri di log peristiwa.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | winddiui.h (termasuk Winddiui.h) |