Password Method

Action2 Example

 

Encapsulates the AutoMate™ action in the “Security” group, “Password.” The method displays a dialog box prompting for a password.

 

Declaration

function Password (varMessageText As Variant,

varPassword As Variant,

intMaxRetries As Integer As Integer

 

Parameters

varMessageText

 The text to be displayed inside the password dialog box.

 

varPassword

 The clear text password to wait for. This is the password the user must enter to successfully proceed.

 

intMaxRetries

 The number of times the user is allowed to retry entering the password before the dialog gives up and fails the method.

 

Description

Use the Password method to display a user dialog requested a password. The text entered by the user is ghosted using asterisks. The user can attempt to reenter the password intMaxRetries times before the method fails.

 

The Password method returns “0” if the user enters the password correctly; otherwise, it returns “1.”