The SecurityCheck Function

Access to all VTS components and Security Manager dialogs is controlled by one function: SecurityCheck. It is a subroutine that can be called from scripting code.

\SecurityManager\SecurityCheck(SecBit, Suppress, UserName)

SecBit is the security bit number that refers to the privilege to check for the current user. Security bit numbers that are less than or equal to 0 are system privileges, while security bit numbers that are greater than 0 are application privileges.

Suppress indicates whether or not you wish the feedback dialog to be suppressed if the security check fails for the specified privilege.

UserName is an optional parameter that indicates the account username (or the caller's account).

SecurityCheck returns the following values:

•      Invalid if the security bit number is invalid.

•      True if the VTS application is operating in unsecured mode (see Modes: Unsecured and Secured States).

•      False if the user does not have Station Mask Bypass privilege and the corresponding station mask bit is not set (see Workstation-specific Access Restrictions).

•      True if the security bit in the appropriate Privileges property is set.

•      True if this bit belongs to a sub-group of a higher privilege and that privilege bit is set.

•      False in all other cases.

If the SecurityCheck function returns Invalid, the scripting code that called SecurityCheck must decide what default behavior is appropriate.