Services:getServiceConfiguration

Method

Purpose

This method gets the current configuration of the specified Microsoft Windows service(s).

Remarks

If the Service parameter is blank or set to ALL then all installed Microsoft Windows services are returned. If a specific service is specified, only that Microsoft Windows service is returned

Type

Synchronous, IMPACT_INFO.

Arguments

 

Name

Type

Description

Service

String

Initial name of Microsoft Windows service

Returns

 

Name

Type

Description

Service

String

Microsoft Windows service internal name. *Table is indexed on Service.

Display Name

String

Microsoft Windows external display name

Service Type

String

The type of the Microsoft Windows service. The service types are:

OWN_PROCESS: Indicates a Win32 service that runs in its own process.

INTERACTIVE_OWN_PROCESS: Indicates a Win32 service that runs in its own process and that can interact with the desktop.

SHARE_PROCESS: Indicates a Win32 service that shares a process with other services.

INTERACTIVE_SHARE_PROCESS: Indicates a Win32 service that shares a process with other services and that can interact with the desktop.

KERNEL_DRIVER: Indicates a device driver.

FILE_SYSTEM_DRIVER: Indicates a file system driver.

Service Start Type

String

The start type of the Microsoft Windows service. The service types are:

DEMAND_START: Specifies a device driver or Win32 service started by the service control manager when a process calls the StartService function (e.g. Services Control Panel Applet).

AUTO_START: Specifies a device driver or Win32 service started by the service control manager automatically during system startup.

DISABLED: Specifies a device driver or Win32 service that can no longer be started.

BOOT_START: Specifies a device driver started by the system loader.

SYSTEM_START: Specifies a device driver started by the IoInitSystem function.

Service Error Control

String

Specifies the severity of the error if this Microsoft Windows service fails to start during startup, and determines the action taken by the startup program if failure occurs. The error controls are:

IGNORE: The startup (boot) program logs the error but continues the startup operation.

NORMAL: The startup program logs the error and displays a message box pop-up but continues the startup operation.

SEVERE: The startup program logs the error. If the last-known good configuration is being started, the startup operation continues. Otherwise, the system is restarted with the last known good configuration.

CRITICAL: The startup program logs the error, if possible. If the last-known good configuration is being started, the startup operation fails. Otherwise, the system is restarted with the last-known good configuration.

Binary Path

String

The fully qualified path to the Microsoft Windows service binary file

Load Order Group

String

The names of the load ordering group of which this Microsoft Windows service is a member. If the field is blank the service does not belong to a group.

Tag ID

Integer

Specifies a unique tag value for this Microsoft Windows service in the group specified by the Load Order Group value. A value of zero indicates that the service has not been assigned a tag.

Account

String

The account name, in the form of DomainName\Username, which the log-on name of the service process when it is run.