The ICustomActionsComponent Guide: Building Custom Features Into Any Application

Table of Contents

• Introduction
• Registration
• Using Advanced Installer
  • GUI
  • Working with Projects
  • Installer Project
  • Patch Project
  • Merge Module Project
  • Updates Configuration Project
  • Windows Store App Project
  • Modification Package Project
  • Optional Package Project
  • Windows Mobile CAB Projects
  • Visual Studio Extension Project
  • Software Installer Wizards - Advanced Installer
  • Visual Studio integration
  • Alternative to AdminStudio/Wise
  • Replace Wise
  • Migrating from Visual Studio Installer
  • Keyboard Shortcuts
  • Shell Integration
  • Command Line
  • Advanced Installer PowerShell Automation Interfaces
    * IAdvancedInstaller
    * IAdvinstProject
    * IProductDetails
    * IFolder
    * ILaunchConditionsComponent
    * IFilesComponent
    * IIniFilesComponent
    * IShortcut
    * ITempFile
    * IXmlFile
    * IDirectoryMember
    * IRegistryComponent
    * IInstallParameters
    * IBuildComponent
    * ITextFileUpdatesComponent
    * ITextUpdateFile
    * ITextUpdateAppendOrCreate
    * ITextUpdateReplace
    * IFileAssociations
    * IDefaultProgramFA
    * IExtensionFA
    * IProgIdFA
    * IVerbFA
    * IEnvironment
    * IEnvironmentVariable
    * IProductCode
    * IUpgradeCode
    * IMergeModulesComponent
    * IMergeModule
    * IDigitalSignature
    * ICustomActionsComponent
    * ICustomAction
    * ICustomActionSequence
    * IAttachedFileCustomAction
    * IAttachedScriptFileCustomAction
    * IDotNetCustomAction
    * IExeWithWorkingDirectoryCustomAction
    * IFileCustomAction
    * IInstalledFileCustomAction
    * IInstalledScriptFileCustomAction
    * IPowershellScriptFile
    * IPowershellAttachedScriptFile
    * IInstallCertificate
    * IUninstallCertificate
    * IFileFromPropertyCustomAction
    * IScriptFileFromPropertyCustomAction
    * IAttachedDllFunctionCallCustomAction
    * IInstalledDllFunctionCallCustomAction
    * ITranslationsComponent
    * IDriversComponent
    * ISearch
    * IServices
    * IOrganizationComponent
    * IComComponent
    * IRemoveFilesComponent
    * IRemoveFile
    * IUpdatesProject
    * IUpdaterComponent
    * IPatchProject
    * IPropertyComponent
    * IProperty
    * IPathVariable
    * IMsixComponent
    * IMsixDependencies
    * IMsixDriverDependency
    * IMsixDriverConstraint
    * IMsixExternalDependency
    * IMsixPackageDependency
• Features and Functionality
• Tutorials
• Samples
• How-tos
• FAQs
• Windows Installer
• Deployment Technologies
• IT Pro
• MSIX
• Video Tutorials
• Advanced Installer Blog
• Table of Contents

Disclaimer: This post includes affiliate links

If you click on a link and make a purchase, I may receive a commission at no extra cost to you.

ICustomActionsComponent

Declaration

ICustomActionsComponent : IDispatch

Overview

This component is meant to create and manage existing predefined custom actions.

Properties

Array CustomActions - Gets existing custom actions.

Methods

NewLaunchInstalledFile(IFile aFile) returns IInstalledFileCustomAction
- Creates custom action for launching installed file.

NewLaunchInstalledScriptFile(IFile aFile) returns IInstalledScriptFileCustomAction
- Creates custom action for launching installed script file.

NewLaunchAttachedFile(String aSourcePath) returns IAttachedFileCustomAction
- Creates custom action for launching attached file.

NewLaunchAttachedScriptFile(String aSourcePath) returns IAttachedScriptFileCustomAction
- Creates custom action for launching attached script file.

NewAttachedNativeDllFunctionCall (String aDllSourcePath) returns IAttachedDllFunctionCallCustomAction
- Creates custom action for calling function from attached native dll

NewInstalledNativeDllFunctionCall(IFile aInstalledDll) returns IInstalledDllFunctionCallCustomAction
- Creates custom action for calling function from installed native dll

NewLaunchFileFromDisk(String aFileToLaunch) returns IFileCustomAction
- Creates custom action for launching existing file from disk.

NewLaunchExeWithWorkingDirectory(IFolder aWorkingDirectory) returns IExeWithWorkingDirectoryCustomAction
- Creates custom action for launching executable file specifying the working directory.

NewDotNetCustomAction(IFile aDotNetDll) returns Array
- Creates custom action that launches a .NET Assembly. The assembly must have a class that inherits the Installer class with the RunInstaller attribute set to true. Can return 2 custom action objects, one for x86 and one for x64 when dll is built for “Any CPU” platform.

NewLaunchInstalledFile(IFile aFile) returns IInstalledFileCustomAction
- Creates custom action for launching installed file.

NewLaunchFileFromProperty(String aPropertyName) returns IFileFromPropertyCustomAction
- Creates custom action for launching executable file using a property.

NewLaunchScriptFileFromProperty(String aPropertyName) returns IScriptFileFromPropertyCustomAction
- Creates custom action for launching script file using a property.

NewPowershellScriptFileFromDisk creates custom action for executing an existing PowerShell script file from target machine.

NewPowershellAttachedScriptFile(String aScriptSourcePath) returns IPowershellAttachedScriptFile
- Creates custom action for executing and attached PowerShell script file.

NewInstallCertificate(String aCertificateFile, String aStoreName) returns IInstallCertificate
- Creates custom action that installs a certificate included in the installer. It requires administrative privileges to run, so make sure you set “Run as Administrator” option from Install Parameters.

NewUninstallCertificate(String aCertificateThumbprint, String aStoreName) returns IUninstallCertificate
- Creates custom action that uninstalls a certificate. It requires administrative privileges to run, so make sure you set “Run as Administrator” option from Install Parameters.

RemoveCustomAction(ICustomActions aCustomAction)
-Removes an existing custom action .

Example

$advinst = new-object -com AdvancedInstaller
$project = $advinst.CreateProjectS(“architect”)
$appFile = $project.FilesComponent.AddFileS(“appdir”, “D:\MyApp.exe”)
$project.CustomActionsComponent.NewLaunchAttachedScriptFile(“d:\my_script.vbs”)

Copy

See also

ICustomAction

ICustomActionSequence

Topics

• ICustomAction
  Interface for base custom action.
• ICustomActionSequence
  Interface for custom action sequence condition.
• IAttachedFileCustomAction
  Interface for launching attached file custom action.
• IAttachedScriptFileCustomAction
  Interface for launching attached script file custom action.
• IDotNetCustomAction
  Interface for .NET custom action.
• IExeWithWorkingDirectoryCustomAction
  Interface for launching executable file custom action.
• IFileCustomAction
  Interface for launching file custom action.
• IInstalledFileCustomAction
  Interface for launching installed file custom action.
• IInstalledScriptFileCustomAction
  Interface for launching installed script file custom action.
• IPowershellScriptFile
  Interface for launching Powershell script file custom action.
• IPowershellAttachedScriptFile
  Interface for launching Powershell attached script file custom action.
• IInstallCertificate
  Interface for installing a certificate custom action.
• IUninstallCertificate
  Interface for uninstalling a certificate custom action.
• IFileFromPropertyCustomAction
  Interface for launching file using property custom action.
• IScriptFileFromPropertyCustomAction
  Interface for launching script file using property custom action.
• IAttachedDllFunctionCallCustomAction
  Interface for calling function from attached native dll custom action
• IInstalledDllFunctionCallCustomAction
  Interface for calling function from installed native dll custom action .

Did you find this page useful?

Please give it a rating:

Thanks!

Report a problem on this page

Information is incorrect or missing

Information is unclear or confusing

Something else

Can you tell us what’s wrong?

Send message

Also read: