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.”