MSI Factory 2.3

Create Service

Create Service

Previous topic Next topic  

Create Service

Previous topic Next topic  

MSI Factory

Service

Name:

The service name to install. The name has a maximum length of 256 characters. The service control manager database preserves the case of the characters in the service name, but comparisons of service names are case insensitive. Forward-slash (/) and back-slash (\) are invalid service name characters.

Display name:

The localizable string that user interface programs use to identify the service. The string has a maximum length of 256 characters. The service control manager preserves the case of the display name, but display name comparisons are case insensitive.

Description:

A localizable description for the service being configured. If this field is left blank, the installer uses the existing description of the service if one exists. For more information, see SERVICE_DESCRIPTION in the Microsoft Windows Software Development Kit (SDK).

Erase description:

If checked, the existing description of the service will be erased, regardless of what you enter in the Description field above.

File ID:

The file identifier of the service file that you are installing. The file must be a valid Windows service and must be the key path of its component. This create service action will become a child of the same component by default. You should always keep the file and this action in the same component. You can click the Browse button to select a file from your project.

Startup

Start:

Determines when the service should be started. The Windows Installer does not support boot or system. This attribute's value should be one of the following:

Automatic - Start service during startup of the system.

Manual - The service is started manually.

Disabled - The service can not be started.

Load order group:

The load ordering group that this service should be a part of.  Leave the field empty if the service does not belong to a group.

Error control:

The action taken by the startup program if the service fails to start during startup. These values affect the ServiceControl and StartService events for installed services. Choose from:

Ignore - Logs the error and continues with the startup operation.

Normal - Logs the error, displays a message box and continues the startup operation.

Critical - Logs the error if it is possible and the system is restarted with the last configuration known to be good. If the last-known-good configuration is being started, the startup operation fails.

Service dependencies:

A list of names of services or load ordering groups that the system must start before this service. Separate names in the list by semi-colons (";"). If the service has no dependencies, then leave the field empty. Dependency on a group means that this service can run if at least one member of the group is running after an attempt to start all members of the group. Use the plus sign ("+") in front of a string to indicate that it is a group name. For example, "Service One;+Group Three."

Arguments:

Specifies line arguments or properties required to run the service.

Type of Service

Type:

The type of service that you are installing. Choose from:

Own process - A Microsoft Win32 service that runs its own process.

Shared process - A Win32 service that shares a process.

Vital

If checked, the overall install should fail if this service fails to install.

Interactive

If checked it indicates that the service interacts with the desktop.

Account:

The account under which to start the service if "Type" is set to "Own Process." Use an account name in the form: DomainName\UserName, or if the account belongs to the built-in domain it is permitted to specify .\UserName.

Password:

The string password to the Account name. Note that the user must have permissions to log on as a service.

More Information

MSDN Online: ServiceInstall Table

WiX Help File: ServiceInstall Element


Learn More: Indigo Rose Software - MSI Factory - Buy Now - Contact Us