Skip to main content
Version: v3

ServiceConfig Element

Description
Configures a service being installed or one that already exists. This element's functionality is available starting with MSI 5.0.
Windows Installer references
MsiServiceConfig Table
Parents
Component, ServiceInstall
Inner Text
None
Children
Choice of elements (min: 0, max: unbounded)
Attributes
NameTypeDescriptionRequired
DelayedAutoStartString This attribute specifies whether an auto-start service should delay its start until after all other auto-start services. This attribute only affects auto-start services. Allowed values are "yes", "no" or a Formatted property that resolves to "1" (for "yes") or "0" (for "no"). If this attribute is not present the setting is not configured.  
FailureActionsWhenString This attribute specifies when failure actions should be applied. Allowed values are "failedToStop", "failedToStopOrReturnedError" or a Formatted property that resolves to "1" (for "failedToStopOrReturnedError") or "0" (for "failedToStop"). If this attribute is not present the setting is not configured.  
IdString Unique identifier for this service configuration. This value will default to the ServiceName attribute if not specified.  
OnInstallYesNoType Specifies whether to configure the service when the parent Component is installed. This attribute may be combined with OnReinstall and OnUninstall.  
OnReinstallYesNoType Specifies whether to configure the service when the parent Component is reinstalled. This attribute may be combined with OnInstall and OnUninstall.  
OnUninstallYesNoType Specifies whether to configure the service when the parent Component is uninstalled. This attribute may be combined with OnInstall and OnReinstall.  
PreShutdownDelayString This attribute specifies time in milliseconds that the Service Control Manager (SCM) waits after notifying the service of a system shutdown. If this attribute is not present the default value, 3 minutes, is used.  
ServiceNameString Specifies the name of the service to configure. This value will default to the ServiceInstall/@Name attribute when nested under a ServiceInstall element.  
ServiceSidString Specifies the service SID to apply to the service. Valid values are "none", "restricted", "unrestricted" or a Formatted property that resolves to "0" (for "none"), "3" (for "restricted") or "1" (for "unrestricted"). If this attribute is not present the setting is not configured.  
Remarks

MsiServiceConfig functionality is documented in the Windows Installer SDK to "not [work] as expected." Consider using the WixUtilExtension ServiceConfig instead.

See Also
Wix Schema