Expression of String type - reference to a value of String
type.
descriptIN_Str
in
Identifier of Str type - user description for the name, used after the registration is successful.
Description
The action, within the script interpreter
( D2000 EventHandler or
D2000 HI)
or within the application (when using the key word PUBLIC) registers an unique
name given by the expression strExpression_Str. In case, that
such the name exists, it returns the value FALSE. If the name doesn't exist,
it performs the registration and returns TRUE value. Another (others)
instances of an arbitrary script will be unsuccessful during an attempting to
register the same name (string).
The key word PUBLIC acts, that an registered name (string) is to
be published for all scripts (system script or active picture) in the
application scope. This registration is provided by the process
D2000 Server.
A registered string without any PUBLIC keyword is only known within
the frame of the process, in which the script is interpreted (D2000 EventHandler
or
D2000 HI).
After the name registration is not successful, a text identifying the script
that registered the name first is to be retrieved by the parameter descriptOUT_Str.
The format of the text is following:
computerName;processName;objectName;description
computerName
name of the computer where the process that performed the
registration is running
processName
name of the object of Process type
that performed the registration
objectName
name of the object that performed the registration (object of
Event type or
active picture)
description
value of the parameter descriptIN_Str of the action that
registered the name
If the registration was performed by an object within the same process, computerName and processName
will be empty strings
(e.g. ;;E.Event).
The Tell command
SHOW_ACCESS_LIST allows to get a list of the names registered by the
action GETACCESS within the application (with the keyword PUBLIC).