2.2.1.19.1 Element-Specific Attributes

Attribute Name

Description

serviceAction

MUST be NOCHANGE, START, STOP, RESTART, or RESTART_IF_REQUIRED. This attribute defines the action that is to be performed on the service. If RESTART_IF_REQUIRED is specified, if startupType is set to AUTOMATIC or BOOT and the service is not started at the time the protocol executes, the service MUST be started.

startupType

Sets the startup type for the service. MUST be NOCHANGE, AUTOMATIC, BOOT, DISABLED, MANUAL, or SYSTEM.

serviceName

Sets the unique name for the service.

Note A service's unique name does not always match its display name. For example, the unique name of the Server service is LanmanServer.

timeout

Sets a time-out value, in seconds, that the preference protocol waits to write configuration data, if the service is locked.

accountName

(optional) Sets the user name for the service's logon credentials.

cPassword

(optional) MUST be the password used to authenticate the user. The password is encrypted using an AES encryption key before being saved in the service item. The password is decrypted by the client during client processing.

Note The password is decrypted by the Service client-side protocol.

interact

(optional) MUST be 1 to allow the service to interact with the desktop. The default value is 0.

firstFailure

(optional) MUST be START, STOP, RESTART, NOACTION, or RESTART_IF_REQUIRED to describe the behavior of the service after the first failure.

secondFailure

(optional) MUST be START, STOP, RESTART, NOACTION, or RESTART_IF_REQUIRED to describe the behavior of the service after the second failure.

thirdFailure

(optional) MUST be START, STOP, RESTART, NOACTION, or RESTART_IF_REQUIRED to describe the behavior of the service after the third failure.

resetFailCountDelay

(optional) MUST be the number of supported failure actions.

restartServiceDelay

(optional) MUST be the time, in seconds, before the failure action is initiated.

restartComputerDelay

(optional) MUST be the time, in seconds, before the restart action is initiated.

restartMessage

(optional) MUST be the message broadcast to the client prior to a restart.

program

(optional) MUST be the full path to the program that executes in the event of a failure.

args

(optional) MUST be the arguments passed to the program that executes in the event of a failure.

append

(optional) MUST be the arguments appended to the default arguments that are passed to the program that executes in the event of a failure.