Fungsi DllInstall (shlwapi.h)

Menangani penginstalan dan penyiapan untuk DLL.

Sintaks

HRESULT DllInstall(
                 BOOL   bInstall,
  [in, optional] PCWSTR pszCmdLine
);

Parameter

bInstall

Jenis: BOOL

TRUE jika DLL sedang diinstal; FALSE jika sedang dihapus instalasinya.

[in, optional] pszCmdLine

Jenis: PCWSTR

String yang diteruskan oleh regsvr32 yang menunjukkan prosedur penyiapan mana yang akan digunakan. Nilai ini bisa NULL.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Fungsi ini dapat diimplementasikan dan diekspor berdasarkan nama oleh DLL untuk digunakan selama penginstalan atau penyiapan aplikasi. Ini dipanggil oleh regsvr32 untuk memungkinkan DLL melakukan tugas seperti menambahkan informasi ke registri.

DllInstall hanya digunakan untuk penginstalan dan penyiapan aplikasi. Ini tidak boleh dipanggil oleh aplikasi. Ini mirip dengan DllRegisterServer atau DllUnregisterServer. Tidak seperti fungsi-fungsi ini, DllInstall mengambil string input yang dapat digunakan untuk menentukan berbagai tindakan yang berbeda. Ini memungkinkan DLL diinstal dengan lebih dari satu cara, berdasarkan kriteria apa pun yang sesuai.

Untuk menggunakan DllInstall dengan regsvr32, tambahkan bendera "/i" diikuti dengan titik dua (:) dan string. String akan diteruskan ke DllInstall sebagai parameter pszCmdLine . Jika Anda menghilangkan titik dua dan string, pszCmdLine akan diatur ke NULL. Contoh berikut akan digunakan untuk menginstal DLL.

regsvr32 /i:"Install_1" dllname.dll

DllInstall dipanggil dengan bInstall diatur ke TRUE dan pszCmdLine diatur ke "Install_1". Untuk menghapus instalasi DLL, gunakan yang berikut ini:

regsvr32 /u /i:"Install_1" dllname.dll

Dengan kedua contoh di atas, DllRegisterServer atau DllUnregisterServer juga akan dipanggil. Untuk memanggil DllInstall saja, tambahkan bendera "/n".

regsvr32 /n /i:"Install_1" dllname.dll

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
DLL	Shlwapi.dll (versi 4.71 atau yang lebih baru)