Share via

Tindakan Kustom Tipe 21

  • Artikel

Tindakan kustom ini ditulis dalam JScript, seperti ECMA 262. Pemasang Windows tidak mendukung JScript 1.0. Untuk informasi selengkapnya, lihat Skrip.

Sumber

Skrip diinstal dengan aplikasi selama sesi saat ini. Bidang Sumber dari tabel CustomAction berisi kunci ke tabel File. Lokasi kode tindakan kustom ditentukan oleh resolusi jalur target untuk file ini; oleh karena itu tindakan kustom ini harus dipanggil setelah file diinstal dan sebelum dihapus.

Ketik Nilai

Sertakan nilai berikut dalam kolom Jenis tabel CustomAction untuk menentukan jenis numerik dasar tindakan kustom 32-bit.

Konstanta Heksadesimal Desimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile 0x015 21

 

Pemasang Windows dapat menggunakan Tindakan Kustom 64-bit pada sistem operasi 64-bit. Tindakan kustom 64-bit berdasarkan skrip harus menyertakan bit msidbCustomActionType64BitScript dalam jenis numeriknya. Untuk informasi, lihat Tindakan Kustom 64-bit. Sertakan nilai berikut dalam kolom Jenis tabel CustomAction untuk menentukan jenis numerik dasar dari tindakan kustom 64-bit.

Konstanta Heksadesimal Desimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001015 4117

 

Target

Bidang Target dari tabel CustomAction berisi fungsi skrip opsional. Pemrosesan terlebih dahulu mengirimkan skrip untuk penguraian lalu memanggil fungsi skrip opsional.

Opsi Pemrosesan Kembali

Sertakan bit bendera opsional di kolom Jenis tabel CustomAction untuk menentukan opsi pemrosesan pengembalian. Untuk deskripsi opsi dan nilai, lihat Opsi Pemrosesan Pengembalian Tindakan Kustom.

Opsi Penjadwalan Eksekusi

Sertakan bit bendera opsional di kolom Jenis tabel CustomAction untuk menentukan opsi penjadwalan eksekusi. Opsi ini mengontrol beberapa eksekusi tindakan kustom. Untuk deskripsi opsi, lihat Opsi Penjadwalan Eksekusi Tindakan Kustom.

Opsi Eksekusi In-Script

Sertakan bit bendera opsional di kolom Jenis tabel CustomAction untuk menentukan opsi eksekusi dalam skrip. Opsi ini menyalin kode tindakan ke dalam eksekusi, pembatalan, atau skrip penerapan. Untuk deskripsi opsi, lihat Tindakan Kustom In-Script Opsi Eksekusi.

Nilai yang Dikembalikan

Fungsi opsional yang ditulis dalam skrip harus mengembalikan salah satu nilai yang dijelaskan dalam Nilai Pengembalian JScript dan Tindakan Kustom VBScript.

Keterangan

Tindakan kustom yang ditulis dalam JScript atau VBScript memerlukan objek Sesi penginstalan. Alat penginstal melampirkan Objek Sesi ke skrip dengan nama "Sesi". Karena objek Sesi mungkin tidak ada selama putar kembali penginstalan, tindakan kustom yang ditangguhkan yang ditulis dalam skrip harus menggunakan salah satu metode atau properti objek Sesi yang dijelaskan di bagian Mendapatkan Informasi Konteks untuk Tindakan Kustom Eksekusi yang Ditangguhkan untuk mengambil konteksnya.

Tindakan kustom yang mereferensikan file yang diinstal sebagai sumbernya, seperti Tindakan Kustom Tipe 21 (JScript), harus mematuhi pembatasan pengurutan berikut:

  • Tindakan kustom harus diurutkan setelah tindakan CostFinalize. Ini agar tindakan kustom dapat menyelesaikan jalur yang diperlukan untuk menemukan file sumber yang berisi JScript.
  • Jika file sumber belum diinstal pada komputer, tindakan kustom yang ditangguhkan (dalam skrip) jenis ini harus diurutkan setelah tindakan InstallFiles.
  • Jika file sumber belum diinstal pada komputer, tindakan kustom yang tidak ditangguhkan dari jenis ini harus diurutkan setelah tindakan InstallFinalize.

Custom_Actions