Delen via

Aangepast actietype 17

  • Artikel

Deze aangepaste actie roept een DLL (Dynamic Link Library) aan die is geschreven in C of C++.

Bron

Het DLL-bestand wordt tijdens de huidige sessie met de toepassing geïnstalleerd. Het veld Bron van de CustomAction-tabel bevat een sleutel voor de tabel Bestand. De locatie van de aangepaste actiecode wordt bepaald door de resolutie van het doelpad voor dit bestand; daarom moet deze aangepaste actie worden aangeroepen nadat dat bestand is geïnstalleerd en voordat het wordt verwijderd.

Typewaarde

Neem de volgende waarde op in de kolom Type van de CustomAction-tabel om het numerieke basistype op te geven.

Constanten Hexadecimaal Decimaal
msidbCustomActionTypeDll + msidbCustomActionTypeSourceFile 0x011 17

 

Doel

Het DLL-bestand wordt aangeroepen via het toegangspunt dat is genoemd in het veld Doel van de CustomAction-tabel, waarbij één argument wordt doorgegeven aan de huidige installatiesessie. De naam van het toegangspunt dat in de tabel is opgegeven, moet overeenkomen met de naam die is geëxporteerd uit het DLL-bestand. Houd er rekening mee dat als de invoerfunctie niet is opgegeven door een . DEF-bestand of door een /EXPORT: linkerspecificatie, de naam kan een voorlooponderstrepingsteken en een achtervoegsel '@4' hebben. De aangeroepen functie moet de __stdcall aanroepende conventie opgeven.

Opties voor retourverwerking

Voeg optionele vlag-bits toe in de kolom Type van de CustomAction-tabel om retourverwerkingsopties op te geven. Zie Aangepaste opties voor retourverwerkingvoor een beschrijving van de opties en waarden.

Opties voor het plannen van de uitvoering

Voeg optionele vlag-bits toe in de kolom Type van de CustomAction-tabel om de planningsopties voor de uitvoering op te geven. Deze opties bepalen de meerdere uitvoering van aangepaste acties. Zie Opties voor het plannen van aangepaste actiesvoor een beschrijving van de opties.

In-Script uitvoeringsopties

Voeg optionele vlag-bits toe in de kolom Type van de CustomAction-tabel om een optie voor het uitvoeren van scripts op te geven. Met deze opties kopieert u de actiecode naar het uitvoerings-, terugdraai- of doorvoerscript. Zie Aangepaste actie In-Script uitvoeringsoptiesvoor een beschrijving van de opties.

Retourwaarden

Zie aangepaste actie retourwaarden.

Opmerkingen

Een aangepaste actie die een DLL (Dynamic Link Library) aanroept, vereist een ingang voor de installatiesessie. Als dit ook een aangepaste actie voor de uitgestelde uitvoering is, bestaat de sessie mogelijk niet meer tijdens het uitvoeren van het installatiescript. Zie Contextinformatie verkrijgen voor aangepaste uitvoeringsactiesvoor informatie over hoe een aangepaste actie van dit type contextinformatie kan verkrijgen.

Aangepaste acties worden uitgevoerd in een afzonderlijke thread en hebben mogelijk beperkte toegang tot het systeem. Aangepaste acties die asynchroon worden uitgevoerd, blokkeren de hoofdthread bij beëindiging van de huidige reeks of de installatiesessie totdat ze terugkeren.

Aangepaste acties die verwijzen naar een geïnstalleerd bestand als bron, zoals aangepast actietype 17 (DLL), moeten voldoen aan de volgende sequentiebeperkingen:

  • De aangepaste actie moet worden gesequentieerd na de actie CostFinalize. Dit is zodat de aangepaste actie het pad kan oplossen dat nodig is om het DLL-bestand te vinden.
  • Als het bronbestand nog niet op de computer is geïnstalleerd, moeten aangepaste acties van dit type (in-script) worden gesequentieerd na de actie InstallFiles.
  • Als het bronbestand nog niet op de computer is geïnstalleerd, moeten niet-uitgestelde aangepaste acties van dit type worden gesequentieerd na de InstallFinalize-actie.

Custom_Actions

aangepaste acties voor uitgestelde uitvoering

Dynamic-Link bibliotheken