Bagikan melalui

Menerapkan Tindakan Finish-Install

  • Artikel

Catatan

Fitur yang dijelaskan di bagian ini tidak didukung dalam paket driver universal atau seluler. Lihat Menggunakan File INF Universal.

Alat penginstal (alat penginstal kelas, penginstal bersama kelas, atau penginstal bersama perangkat) menyediakan tindakan penginstal akhir. Tindakan selesai menginstal dapat menjalankan program yang dapat dieksekusi, membuat proses, membuat utas, atau menjalankan kode dalam proses penginstalan penginstalan pengandar perangkat selesai diinstal.

Untuk menerapkan tindakan penginstalan akhir, alat penginstal:

  1. Mengatur bendera DI_FLAGSEX_FINISHINSTALL_ACTION saat alat penginstal memproses kode DIF DIF_NEWDEVICEWIZARD_FINISHINSTALL dan mengembalikan salah satu kode kesalahan berikut:

    • ERROR_DI_DO_DEFAULT jika itu adalah penginstal kelas tanpa halaman wizard selesai diinstal.
    • NO_ERROR apakah itu adalah penginstal kelas dengan halaman wizard selesai-instal atau penginstal bersama dengan atau tanpa halaman wizard selesai-instal.

  2. Melakukan tindakan selesai menginstal saat memproses permintaan DIF_FINISHINSTALL_ACTION .

    Alat penginstal mengembalikan salah satu kode kesalahan dalam tabel berikut.

    Kode kesalahan Makna

    ERROR_DI_DO_DEFAULT

    Penginstal kelas: Penginstal kelas telah berhasil menjalankan tindakan penginstalan akhir dan meminta Windows untuk melakukan pemrosesan defaultnya. Penginstal kelas juga harus mengembalikan kode kesalahan ini jika tidak memiliki tindakan selesai diinstal.

    Penginstal bersama perangkat atau kelas: Penginstal bersama tidak mengembalikan kode kesalahan ini.

    NO_ERROR

    Penginstal kelas: Penginstal kelas telah berhasil menjalankan tindakan penginstalan akhir. Windows tidak boleh melakukan pemrosesan defaultnya.

    Penginstal bersama perangkat atau kelas: Penginstal bersama telah berhasil menjalankan tindakan penginstalan akhir atau tidak memiliki tindakan penginstalan akhir.

    Kesalahan Microsoft Win32

    Alat penginstal mengalami kesalahan, tetapi tindakan selesai-instal harus dicoba lagi. Mengembalikan kode kesalahan Win32 menunjukkan bahwa Windows harus menjalankan proses penginstalan akhir lainnya untuk menyelesaikan tindakan selesai-instal saat perangkat dijumlahkan.

Catatan Jika tindakan selesai diinstal gagal dan tidak boleh dicoba lagi, penginstal kelas mengembalikan ERROR_DI_DO_DEFAULT dan penginstal bersama perangkat atau kelas mengembalikan NO_ERROR.

Untuk informasi tentang cara mengembangkan tindakan penginstalan akhir, lihat Panduan Penerapan Tindakan Finish-Install Untuk kode sampel yang menunjukkan cara menerapkan tindakan penginstalan akhir, lihat topik berikut:

Contoh Kode: Finish-Install Tindakan di Penginstal Kelas

Contoh Kode: Finish-Install Tindakan dalam Penginstal Bersama