Services:getServiceStatus

Method

Purpose

This method gets the current status of the specified Microsoft Windows service(s). If the Service parameter is blank or set to ALL then all installed Microsoft Windows services are returned. If a specific service is specified then only that Microsoft Windows service is returned.

Type

Synchronous, IMPACT_INFO.

Arguments

 

Name

Type

Description

Service

String

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

Current State

String

The current state of the Microsoft Windows service. The service states are:

STOPPED: The service is not running.

START_PENDING: The service is starting.

STOP_PENDING: The service is stopping.

RUNNING: The service is running.

CONTINUE_PENDING: The service continue is pending.

PAUSE_PENDING: The service pause is pending.

PAUSED: The service is paused.

Win32 Exit Code

Integer

The error code of the last error returned by the Microsoft Windows service.

Exit Code Description

String

The description of the last error returned by the Microsoft Windows service.

Service Exit Code

Integer

The service specific return code from the Microsoft Windows service.

Controls Accepted

String

The control commands accepted by the Microsoft Windows service. If more than one control is specified they are listed in blank-delimited format. The controls accepted may be any combination of the following:

STOP: The service can be stopped.

PAUSE_CONTINUE: The service can be paused and continued.

SHUTDOWN: The service is notified when system shutdown occurs allowing the system to shut down this service.

Check Point

Integer

The last check point of the Microsoft Windows service

Wait Hint

Integer

The last wait hint suggested by the Microsoft Windows service