Niestandardowy typ akcji 17
Ta akcja niestandardowa wywołuje bibliotekę linków dynamicznych (DLL) napisaną w języku C lub C++.
Źródło
Biblioteka DLL jest instalowana z aplikacją podczas bieżącej sesji. Pole Źródło tabeli CustomAction zawiera klucz do tabeli File. Lokalizacja kodu akcji niestandardowej jest określana przez rozdzielczość ścieżki docelowej dla tego pliku; dlatego ta akcja niestandardowa musi być wywoływana po zainstalowaniu tego pliku i przed jego usunięciem.
Wartość typu
Uwzględnij następującą wartość w kolumnie Typ tabeli CustomAction, aby określić podstawowy typ liczbowy.
| Stałe | Szesnastkowych | Dziesiętny |
|---|---|---|
| msidbCustomActionTypeDll + msidbCustomActionTypeSourceFile | 0x011 | 17 |
Cel
Biblioteka DLL jest wywoływana za pośrednictwem punktu wejścia o nazwie w polu Target tabeli CustomAction, przekazując jeden argument, który jest dojściem do bieżącej sesji instalacji. Nazwa punktu wejścia określona w tabeli musi być zgodna z nazwą wyeksportowaną z biblioteki DLL. Należy pamiętać, że jeśli funkcja entry nie jest określona przez element . Plik DEF lub według /EXPORT: specyfikacja konsolidatora, nazwa może mieć wiodący znak podkreślenia i sufiks "@4". Wywołana funkcja musi określać konwencję wywoływania __stdcall.
Opcje przetwarzania zwrotnego
Uwzględnij opcjonalne bity flagi w kolumnie Typ tabeli CustomAction w celu określenia opcji przetwarzania zwrotnego. Aby zapoznać się z opisem opcji i wartości, zobacz Opcje przetwarzania powrotnego akcji niestandardowej.
Opcje planowania wykonywania
Dołącz opcjonalne bity flagi w kolumnie Typ tabeli CustomAction, aby określić opcje planowania wykonywania. Te opcje kontrolują wielokrotne wykonywanie akcji niestandardowych. Aby uzyskać opis opcji, zobacz Opcje planowania wykonywania akcji niestandardowych.
Opcje wykonywania In-Script
Dołącz opcjonalne bity flagi w kolumnie Typ tabeli CustomAction, aby określić opcję wykonywania skryptu. Te opcje kopiują kod akcji do skryptu wykonywania, wycofywania lub zatwierdzania. Aby zapoznać się z opisem opcji, zobacz opcje wykonywania niestandardowego In-Script.
Zwracane wartości
Zobacz wartości zwracane akcji niestandardowej.
Uwagi
Akcja niestandardowa, która wywołuje bibliotekę łącza dynamicznego (DLL), wymaga dojścia do sesji instalacji. Jeśli jest to również akcja niestandardowa wykonania odroczonego, sesja może już nie istnieć podczas wykonywania skryptu instalacji. Aby uzyskać informacje na temat sposobu, w jaki akcja niestandardowa tego typu może uzyskać informacje kontekstowe, zobacz Uzyskiwanie informacji kontekstowych dla akcji niestandardowych wykonania odroczonego.
Akcje niestandardowe są wykonywane w osobnym wątku i mogą mieć ograniczony dostęp do systemu. Akcje niestandardowe uruchamiane asynchronicznie blokują główny wątek po zakończeniu bieżącej sekwencji lub sesji instalacji do momentu ich zwrócenia.
Akcje niestandardowe odwołujące się do zainstalowanego pliku jako źródła, takie jak niestandardowy typ akcji 17 (DLL), muszą być zgodne z następującymi ograniczeniami sekwencjonowania:
- Akcja niestandardowa musi być sekwencjonowana po akcji CostFinalize. Dzięki temu akcja niestandardowa może rozpoznać ścieżkę wymaganą do zlokalizowania biblioteki DLL.
- Jeśli plik źródłowy nie jest jeszcze zainstalowany na komputerze, akcje niestandardowe tego typu (skrypt) odroczone (skrypt) muszą być sekwencjonowane po akcji InstallFiles.
- Jeśli plik źródłowy nie jest jeszcze zainstalowany na komputerze, akcje niestandardowe tego typu nieodroczone muszą być sekwencjonowane po akcji InstallFinalize.
Tematy pokrewne