Sdílet prostřednictvím

Vlastní typ akce 17

  • Článek

Tato vlastní akce volá dynamickou knihovnu odkazů (DLL) napsanou v jazyce C nebo C++.

Zdroj

Knihovna DLL je nainstalována s aplikací během aktuální relace. Pole Zdroj tabulky CustomAction obsahuje klíč k tabulkySoubor . Umístění vlastního kódu akce je určeno překladem cílové cesty pro tento soubor; proto musí být tato vlastní akce volána po instalaci tohoto souboru a před odebráním.

Hodnota typu

Do sloupce Typ tabulky CustomAction zadejte základní číselný typ.

Konstanty Šestnáctkový Desetinný
msidbCustomActionTypeDll + msidbCustomActionTypeSourceFile 0x011 17

 

Cíl

Knihovna DLL je volána prostřednictvím vstupního bodu pojmenovaného v poli Cíl tabulky CustomAction, předání jednoho argumentu, který je popisovač aktuální instalační relace. Název vstupního bodu zadaný v tabulce se musí shodovat s exportem z knihovny DLL. Všimněte si, že pokud vstupní funkce není určena parametrem . Def soubor nebo /EXPORT: specifikace linkeru, název může mít úvodní podtržítko a příponu @4. Volaná funkce musí určit __stdcall konvenci volání.

Možnosti zpracování vrácení

Do sloupce Typ tabulky CustomAction zahrňte volitelné bity příznaků, určit možnosti vrácení zpracování. Popis možností a hodnot najdete v tématu Možnosti zpracování vrácení vlastní akce.

Možnosti plánování provádění

Do sloupce Typ tabulky CustomAction zahrňte volitelné bity příznaků, určit možnosti plánování provádění. Tyto možnosti řídí více provádění vlastních akcí. Popis možností najdete v tématu možnosti plánování provádění vlastních akcí.

možnosti spuštění In-Script

Do sloupce Typ tabulky CustomAction zahrňte volitelné bity příznaku, určit možnost spuštění skriptu. Tyto možnosti zkopírují kód akce do skriptu spuštění, vrácení zpět nebo potvrzení. Popis možností naleznete v tématu vlastní akce In-Script možnosti spuštění.

Návratové hodnoty

Viz návratové hodnoty vlastní akce.

Poznámky

Vlastní akce, která volá dynamickou knihovnu (DLL), vyžaduje popisovač instalační relace. Pokud se jedná také o odloženou vlastní akci spuštění, relace již nemusí existovat během provádění instalačního skriptu. Informace o tom, jak může vlastní akce tohoto typu získat informace o kontextu, naleznete v tématu Získání informací o kontextu pro odložené provádění vlastní akce.

Vlastní akce se spouštějí v samostatném vlákně a mohou mít omezený přístup k systému. Vlastní akce, které spouští asynchronně blokují hlavní vlákno při ukončení aktuální sekvence nebo relace instalace, dokud se nevrátí.

Vlastní akce, které odkazují na nainstalovaný soubor jako zdroj, například vlastní akce typu 17 (DLL), musí dodržovat následující omezení sekvencování:

  • Vlastní akce musí být sekvencována za akcí CostFinalize. To znamená, že vlastní akce dokáže přeložit cestu potřebnou k vyhledání knihovny DLL.
  • Pokud zdrojový soubor ještě není v počítači nainstalovaný, musí být odložené (in-script) vlastní akce tohoto typu sekvencovány po akci InstallFiles.
  • Pokud zdrojový soubor ještě není v počítači nainstalovaný, je nutné po akci InstallFinalizesekvencovat jiné než odložené vlastní akce tohoto typu .

Custom_Actions

vlastních akcí odloženého provádění

Dynamic-Link knihovny