ServiceControl Table
The ServiceControl table is used to control installed or uninstalled services.
Note
Services that rely on the presence of an assembly in the Global Assembly Cache (GAC) cannot be installed or started using the ServiceInstall and ServiceControl tables. If you need to start a service that depends on an assembly in the GAC, you must use a custom action sequenced after the InstallFinalize action or a commit custom action. For information about installing assemblies to the GAC see Installation of Assemblies to the Global Assembly Cache.
The ServiceControl table has the following columns.
| Column | Type | Key | Nullable |
|---|---|---|---|
| ServiceControl | Identifier | Y | N |
| Name | Formatted | N | N |
| Event | Integer | N | N |
| Arguments | Formatted | N | Y |
| Wait | Integer | N | Y |
| Component_ | Identifier | N | N |
Columns
-
ServiceControl
-
This is the primary key of this table.
-
Name
-
This column is the string naming the service. This column can be used to control a service that is not installed.
-
Event
-
This column contains the operations to be performed on the named service. Note that when stopping a service, all services that depend on that service are also stopped. When deleting a service that is running, the installer stops the service.
The values in this field are bit fields that can be combined into a single value that represents several operations.
The following values are only used during an installation.
Constant Hexadecimal Decimal Description msidbServiceControlEventStart 0x001 1 Starts the service during the StartServices action. msidbServiceControlEventStop 0x002 2 Stops the service during the StopServices action. (none) 0x004 4 <reserved> msidbServiceControlEventDelete 0x008 8 Deletes the service during the DeleteServices action. The following values are only used during an uninstall.
Constant Hexadecimal Decimal Description msidbServiceControlEventUninstallStart 0x010 16 Starts the service during the StartServices action. msidbServiceControlEventUninstallStop 0x020 32 Stops the service during the StopServices action. (none) 0x040 64 <reserved> msidbServiceControlEventUninstallDelete 0x080 128 Deletes the service during the DeleteServices action. -
Arguments
-
A list of arguments for starting services. The arguments are separated by null characters [~]. For example, the list of arguments One, Two, and Three are listed as: One[~]Two[~]Three.
-
Wait
-
Leaving this field null or entering a value of 1 causes the installer to wait a maximum of 30 seconds for the service to complete before proceeding. The wait can be used to allow additional time for a critical event to return a failure error. A value of 0 in this field means to wait only until the service control manager (SCM) reports that this service is in a pending state before continuing with the installation.
-
Component_
-
External key to column one of the Component Table.
Remarks
The StartServices, StopServices, and DeleteServices actions in sequence tables process the information in this table. For information about using sequence tables, see Using a Sequence Table.
Use the Name column to start, stop, or delete services that are being replaced by the installation or that are dependent upon a new service that is being installed. For example, entering MyService into the ServiceControl column can tie this service to MyComponent in the Component_ column. If the bit field in the Event column is set for start while installing, then the installer starts MyService when installing MyComponent.
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