Özel Eylem Türü 17
Bu özel eylem, C veya C++ dilinde yazılmış bir dinamik bağlantı kitaplığını (DLL) çağırır.
Kaynak
DLL, geçerli oturum sırasında uygulamayla birlikte yüklenir. CustomAction tablosunun Kaynak alanıDosya tablosubir anahtar içerir. Özel eylem kodunun konumu, bu dosyanın hedef yolunun çözümüne göre belirlenir; bu nedenle, bu özel eylemin bu dosya yüklendikten sonra ve kaldırılmadan önce çağrılmalıdır.
Tür Değeri
Temel sayısal türü belirtmek için CustomAction tablosunun Tür sütununa aşağıdaki değeri ekleyin.
| Sabit | Onaltı -lık | On -da -lık |
|---|---|---|
| msidbCustomActionTypeDll + msidbCustomActionTypeSourceFile | 0x011 | 17 |
Hedef
DLL, CustomAction tablosunun Hedef alanında adlı giriş noktası aracılığıyla çağrılır ve geçerli yükleme oturumuna tanıtıcı olan tek bir bağımsız değişken geçirilir. Tabloda belirtilen giriş noktası adı, DLL'den dışarı aktarılan adla eşleşmelidir. Giriş işlevi tarafından belirtilmezse, bunu unutmayın. DEF dosyası veya /EXPORT: bağlayıcı belirtimi tarafından, adın başında bir alt çizgi ve "@4" son eki olabilir. Çağrılan işlev __stdcall çağırma kuralını belirtmelidir.
dönüş işleme seçenekleri
dönüş işleme seçeneklerini belirtmek için CustomAction tablosunun Tür sütununa isteğe bağlı bayrak bitleri ekleyin. Seçeneklerin ve değerlerin açıklaması için bkz. Özel Eylem İade İşleme Seçenekleri.
Yürütme Zamanlama Seçenekleri
Yürütme zamanlama seçeneklerini belirtmek için CustomAction tablosunun Tür sütununa isteğe bağlı bayrak bitleri ekleyin. Bu seçenekler özel eylemlerin birden çok yürütülmesini denetler. Seçeneklerin açıklaması için bkz. Özel Eylem Yürütme Zamanlama Seçenekleri.
yürütme seçeneklerini In-Script
Betik içi yürütme seçeneği belirtmek için CustomAction tablosunun Tür sütununa isteğe bağlı bayrak bitleri ekleyin. Bu seçenekler eylem kodunu yürütme, geri alma veya işleme betiğine kopyalar. Seçeneklerin açıklaması için bkz. Özel Eylem In-Script Yürütme Seçenekleri.
Dönüş Değerleri
Bkz. Özel Eylem Dönüş Değerleri.
Açıklamalar
Dinamik bağlantı kitaplığını (DLL) çağıran özel bir eylem, yükleme oturumu için bir tanıtıcı gerektirir. Bu da ertelenmiş bir yürütme özel eylemiyse, yükleme betiğinin yürütülmesi sırasında oturum artık mevcut olmayabilir. Bu türdeki özel bir eylemin bağlam bilgilerini nasıl edinebileceği hakkında bilgi için bkz. Ertelenen Yürütme Özel Eylemleri için Bağlam Bilgilerini Alma.
Özel eylemler ayrı bir iş parçacığında yürütülür ve sisteme sınırlı erişime sahip olabilir. Zaman uyumsuz olarak çalışan özel eylemler, dönene kadar geçerli dizinin veya yükleme oturumunun sonlandırıldığında ana iş parçacığını engeller.
Yüklü bir dosyaya kaynağı olarak başvuran Özel Eylem Türü 17 (DLL) gibi özel eylemler aşağıdaki sıralama kısıtlamalarına uymalıdır:
- Özel eylem, CostFinalize eyleminden sonra sıralanmalıdır. Bu, özel eylemin DLL'yi bulmak için gereken yolu çözümleyebilmesi için kullanılır.
- Kaynak dosya bilgisayarda zaten yüklü değilse, bu türdeki ertelenmiş (betik içi) özel eylemler InstallFiles eylemisonra sıralanmalıdır.
- Kaynak dosya bilgisayarda zaten yüklü değilse, bu türdeki ertelenmeyen özel eylemler InstallFinalize eylemisonra sıralanmalıdır.
İlgili konular