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 msidbServiceConfigEventInstall 1
Takes the action during installation of the component. msidbServiceConfigEventUninstall 2
Takes the action during uninstallation of the component. msidbServiceConfigEventReinstall 4
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_START 3
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_INFO 6
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. Separate the privilege constants in the list by [~].
SERVICE_CONFIG_SERVICE_SID_INFO 5
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_INFO 7
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_FLAG 4
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
Build date: 8/13/2009
© 2009 Microsoft Corporation. All rights reserved.