# getpassword

Reads a password.

## Format

    getpassword <filename> <password name> <strvar>

## Remarks

Retrieves an encrypted password identified by <password name> from the password file <filename>.
Decrypts the password and stores it into the string variable <strvar>.

If the specified file does not exist, it is newly created.
If the specified password is not stored in the file, the password dialog box appears and the entered password is stored in <strvar>.
At the same time, the new password is encrypted and written in the file with the identifier <password name>.

A password file can contain multiple passwords.
Each of them is identified by the password identifier.

(version 4.71 or later)
When the password file can not be written, the system variable "result" is set to 0. Otherwise, "result" is set to 1.

## Example

    getpassword 'password.dat' 'mypassword' password
    connect 'myhost'
    wait 'login:'
    sendln 'myname'
    wait 'password:'
    sendln password

    expandenv str "%USERPROFILE%\myfile.dat"
    getpassword str 'mypassword' password
    if !result then
    	messagebox 'Password was not saved' 'ERROR'
    endif

## See also

- "expandenv"