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.

ColumnTypeKeyNullable
MsiServiceConfig Identifier YN
Name Formatted NN
Event Integer NN
ConfigType Integer NN
Argument Formatted NY
Component_ Identifier NN

 

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.

ConstantDescription
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.

ConfigDescription
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 character. 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

ICE102
ICE03
ICE06
ICE32
ICE45
ICE46
ICE69

 

 

Community Additions

ADD
Show:
© 2014 Microsoft