Udostępnij za pośrednictwem


Niestandardowy typ akcji 1

Ta akcja niestandardowa wywołuje bibliotekę linków dynamicznych (DLL) napisaną w języku C lub C++.

Źródło

Biblioteka DLL jest generowana na podstawie tymczasowego strumienia binarnego. Pole Źródło tabeli CustomAction zawiera klucz do tabeli binarnej .

Kolumna Dane w tabeli Binarne zawiera dane strumienia. Oddzielny strumień jest przydzielany dla każdego wiersza. Nowe dane binarne można wstawić z pliku przy użyciu MsiRecordSetStream a następnie MsiViewModify wstawić rekord do tabeli. Po wywołaniu akcji niestandardowej dane strumienia są kopiowane do pliku tymczasowego, który jest następnie przetwarzany w zależności od typu akcji niestandardowej.

Wartość typu

Uwzględnij następujące bity flagi w kolumnie Typ tabeli CustomAction, aby określić podstawowy typ liczbowy.

Stałe Szesnastkowych Dziesiętny
msidbCustomActionTypeDll + msidbCustomActionTypeBinaryData 0x001 1

 

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.

Po wyeksportowaniu tabeli bazy danych każdy strumień jest zapisywany jako oddzielny plik w podfolderze o nazwie po tabeli, używając klucza podstawowego jako nazwy pliku (kolumna Nazwa tabeli Binarnej) z domyślnym rozszerzeniem ".ibd". Nazwa powinna używać formatu 8.3, jeśli system plików lub system kontroli wersji nie obsługuje długich nazw plików. Trwały plik archiwum zastępuje dane strumienia używaną nazwą pliku, dzięki czemu dane mogą znajdować się podczas importowania tabeli.

Custom_Actions

Dynamic-Link biblioteki

uzyskiwanie informacji kontekstowych dla akcji niestandardowych wykonania odroczonego