Handling Failed Service Operations: Best Practices & Strategies

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
    * ITranslationsComponent
    * IDriversComponent
    * ISearch
    * IServices
    * IBaseServiceOperation
    * IServiceControlOperation
    * IServiceFailureOperation
    * IServiceInstallOperation
    * IServiceConfigureOperation
    * 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.

IServiceFailureOperation

Declaration

IServiceFailureOperation : IBaseServiceOperation

Overview

This interface is meant to edit service failure operation properties. A service Failure Operation allows you to set failure actions for a service which is already installed or being installed by the current package.

Properties

Bool ConfigureOnInstall - Gets or sets the configure option during component’s installation.

Bool ConfigureOnUninstall - Gets or sets the configure option during component’s uninstallation.

Bool ConfigureOnReinstall - Gets or sets the configure option during component’s reinstallation.

Array FailureActions - Gets the collection of actions to be taken in case the specified service fails.

Uint DaysBeforeResetFailureCount - Gets or sets the number of days before the number of failures will be reset. The Service Control Manager (SCM) counts the number of times each service has failed since the system was started. When the service fails for Nth time, the system performs the action with the corresponding index in “Failure Actions” list.

String RebootMessage - Gets or sets the message to be sent to network users before restarting the computer in response to a “Restart the computer” action specified in the “Failure Actions” list..

RunProgram - Gets or sets the program to run in response to a “Run a program” action specified in the “Failure Actions” list. Use [~] formatted string to delete the current command and run no program when the service fails. To keep using the current run program leave this field empty..

RunProgramArguments - Gets or sets the the arguments for the specified program to run.

Methods

NewFailureAction(String aActionType, Uint aExecutionDelayInMinutes) returns IFailureAction
Creates a new failure action. Argument “aActionType” supported values: “NoAction”, “RestartService”, “RestartComputer”, “RunProgram”.

RemoveFailureActionAtIndex(Uint aActionIndex)
Removes the failure action at the specified index.

See also

IServiceControlOperation

IBaseServiceOperation

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: