DIF_FINISHINSTALL_ACTION
Permintaan DIF_FINISHINSTALL_ACTION memungkinkan penginstal untuk menjalankan tindakan selesai diinstal dalam konteks administrator interaktif setelah semua operasi penginstalan perangkat lainnya selesai.
Ketika Dikirim
Dalam versi Windows 8 dan yang lebih baru, tindakan penginstalan selesai tidak berjalan secara otomatis sebagai bagian dari penginstalan perangkat. Untuk menyelesaikan tindakan penginstalan selesai perangkat, pengguna harus mengklik "Selesai menginstal perangkat lunak perangkat" di Pusat Tindakan untuk menyelesaikan penginstalan.
Untuk informasi selengkapnya, lihat Menjalankan Tindakan Finish-Install.
Di Windows 7, proses penginstalan selesai hanya berjalan dalam konteks pengguna dengan kredensial administrator pada salah satu waktu berikut:
- Lain kali pengguna yang memiliki kredensial administrator masuk saat perangkat terpasang.
- Ketika perangkat dipasang kembali.
- Saat pengguna memilih Pindai perubahan perangkat keras di Manajer Perangkat.
Jika pengguna masuk tanpa hak administratif, Windows meminta persetujuan dan kredensial kepada pengguna untuk menjalankan tindakan selesai-instal dalam konteks administrator.
Siapa yang Menangani
Penginstal bersama kelas |
Dapat menangani |
Penginstal bersama perangkat |
Dapat menangani |
Penginstal kelas |
Dapat menangani |
Input Alat Penginstal
DeviceInfoSet
Handel ke set informasi perangkat yang berisi perangkat yang sedang diinstal.
DeviceInfoData
Penunjuk ke struktur SP_DEVINFO_DATA yang mewakili perangkat yang diinstal.
Parameter Penginstalan Perangkat
Ada parameter penginstalan perangkat (struktur SP_DEVINSTALL_PARAMS ) yang terkait dengan DeviceInfoData.
Parameter Penginstalan Kelas
Tidak ada
Output Alat Penginstal
Parameter Penginstalan Perangkat
Alat penginstal mengatur bendera DI_NEEDREBOOT jika sistem dimulai ulang diperlukan untuk menyelesaikan tindakan penginstalan selesai.
Nilai Pengembalian Alat Penginstal
Alat penginstal mengembalikan salah satu nilai yang tercantum dalam tabel berikut.
| Mengembalikan nilai | Makna |
|---|---|
ERROR_DI_DO_DEFAULT |
Penginstal kelas: Alat penginstal tidak memiliki tindakan penginstalan akhir, telah berhasil menyelesaikan tindakan penginstalan akhir, atau telah menentukan bahwa penginstal tidak pernah berhasil menyelesaikan tindakan penginstalannya. Penginstalan perangkat harus melakukan pemrosesan default untuk permintaan tersebut. Penginstal bersama: Penginstal bersama tidak boleh mengembalikan kode kesalahan ini. |
NO_ERROR |
Penginstal kelas: Penginstal kelas tidak boleh mengembalikan kode kesalahan ini. Jika penginstal kelas mengembalikan kode kesalahan ini, penginstalan perangkat tidak melakukan pemrosesan default untuk permintaan tersebut. Penginstal bersama: Alat penginstal tidak memiliki tindakan penginstalan akhir, telah berhasil menyelesaikan tindakan penginstalan akhir, atau telah menentukan bahwa alat penginstal tidak dapat berhasil menyelesaikan tindakan penginstalannya. |
Kode kesalahan Win32 |
Penginstal kelas atau penginstal bersama: Alat penginstal mengalami kesalahan saat memproses tindakan selesai diinstal, dan penginstalan perangkat harus mencoba menyelesaikan tindakan penginstalan akhir saat perangkat dijumlahkan dalam konteks administrator. |
Handler Kode DIF Default
Windows 7 menggunakan SetupDiFinishInstallAction.
Tidak ada Handler Kode DIF default di Windows 8 dan versi yang lebih baru, dan SetupDiFinishInstallAction telah dihapus.
Komentar
Karena penginstalan perangkat tidak dapat menentukan dari kode pengembalian ERROR_DI_DO_DEFAULT atau kode pengembalian NO_ERROR apakah tindakan selesai-instal benar-benar berhasil, penginstal harus memberi tahu pengguna tentang status tindakan penginstal akhir.
Untuk informasi selengkapnya tentang tindakan selesai diinstal, lihat Cara Penginstalan Perangkat Memproses Tindakan Finish-Install dan Menerapkan Tindakan Finish-Install.
Untuk informasi umum tentang kode DIF, lihat Menangani Kode DIF dan Memanggil Penangan Kode DIF Default.
Persyaratan
Versi |
Didukung di Windows Vista melalui Windows 7. |
Header |
Setupapi.h (termasuk Setupapi.h) |