MsiServiceConfig Table

The MsiServiceConfig table configures a service that is installed or being installed by the current package.

Windows Installer 4.5 or earlier: Not supported. This table is available beginning with Windows Installer 5.0.

The MsiServiceConfig table has the following columns.

Column Type Key Nullable
MsiServiceConfig Identifier Y N
Name Formatted N N
Event Integer N N
ConfigType Integer N N
Argument Formatted N Y
Component_ Identifier N N

 

Columns

MsiServiceConfig

This is the primary key of this table.

Name

This column contains the name of a service that is a part of this package or that is already is installed.

Event

This column specifies when to change the service configuration. The following values can be combined to represent multiple operations. Any values included other than these are ignored.

Constant Description
msidbServiceConfigEventInstall1
Takes the action during installation of the component.
msidbServiceConfigEventUninstall2
Takes the action during uninstallation of the component.
msidbServiceConfigEventReinstall4
Takes the action during reinstallation of the component.

 

ConfigType

The value in this field, combined with the value in the Arguments field, specify what change to make to the service configuration. The specified change takes effect the next time the system is started.

Config Description
SERVICE_CONFIG_DELAYED_AUTO_START3
Configure the time delay of an auto-start service.
Enter 1 in the Argument field to start the service after other auto-start services plus a time delay.
Enter 0 in the Argument field to turn off the auto-start service delay.
Applies only to installed auto-start services or services installed by this package with SERVICE_AUTO_START in the StartType field of the ServiceInstall table.
SERVICE_CONFIG_REQUIRED_PRIVILEGES_INFO6
Change the list of privileges required by the service.
Enter a list of requested privileges in the Argument field. The Formatted string value in the Argument field lists the Privilege Constants for the requested privileges. You can use the [~] syntax of the Formatted string to insert a null character. Separate the privilege constants in the list by [~].
SERVICE_CONFIG_SERVICE_SID_INFO5
Add a service SID type to the process token containing this service.
Enter in the Argument field a valid service SID type for the SERVICE_SID_INFO structure: SERVICE_SID_TYPE_NONE (0x00), SERVICE_SID_TYPE_RESTRICTED (0x03), or SERVICE_SID_TYPE_UNRESTRICTED (0x01).
SERVICE_CONFIG_PRESHUTDOWN_INFO7
Configure the length of the time the Service Control Manager (SCM) waits before proceeding with other shutdown operations. The SCM waits for this period of time after sending the SERVICE_CONTROL_PRESHUTDOWN notification to the service.
Enter the time delay length, in milliseconds, in the Argument field. Leave the Argument field empty to reset the time delay to the default of 3 minutes.
SERVICE_CONFIG_FAILURE_ACTIONS_FLAG4
Configure when to run the failure actions for this service. This setting is ignored if the service has no configured failure actions.
Enter 0 to run the actions only if the service terminates without reporting SERVICE_STOPPED.
Enter 1 to run the actions if the service terminates reporting SERVICE_STOPPED and the dwWin32ExitCode member of SERVICE_STATUS structure is not ERROR_SUCCESS. Configured failure actions are also run if the service terminates without reporting SERVICE_STOPPED.

 

Argument

The value in this field, combined with the value in the ConfigType field, specify what change to make to the service configuration. The specified change takes effect the next time the system is started.

Component_

External key to the Component column of the Component Table.

Validation

ICE102
ICE03
ICE06
ICE32
ICE45
ICE46
ICE69