RenameState Method (StateSet collection)

                

 

Changes the string representation of a DigitalState within the StateSet. The DigitalState is changed on the Server as well as in the memory representation of the object.

 

Syntax

object.RenameState OldName,NewName

The RenameState method syntax has these parts:

Part

Description

object

An object expression that evaluates to a StateSet collection.

OldName

A string containing the name of the DigitalState to be modified. Must exist in the current StateSet.

NewName

 A string containing the new name for the DigitalState identified by OldName.

 

Remarks

 

Trappable Errors

In addition to generic errors (such as Out of Memory), the following errors may occur:

Error

Description

pseLOADSTATESET

Unable to load the current StateSet from the server.

pseSTATENOTFOUND

The DigitalState specified by oldName was not found.

pseSTATERENAME

Unable to rename the DigitalState on the server. The error description contains more specific information.

Enabling Operational Intelligence