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
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for