  |
GoFiler Legato Script Reference
Legato v 1.5b Application v 5.24b
|
| Table of Contents | < < Previous | Next >> |
Chapter Five — General Functions (continued)
Overview
The PasswordChangeBox function displays a dialog requiring a user to authenticate an existing password and then allowing them to enter a new password.
Syntax/Parameters
Syntax
string = PasswordChangeBox ( string oldpassword, [string title], [string description]);
Parameters
oldpassword
A string containing the password that the user must match in order to continue. The old password can be a maximum of 63 characters.
title
An optional string specifying the title of the password box to a maximum of 255 characters. If the string is empty, the default title is used.
description
An optional string specifying a description to be displayed in the top of the box to a maximum of 512. If omitted, this area of the dialog is collapsed.
Return Value
A string containing the new password entered by the user or empty on failure. Use the GetLastError function to retrieve a formatted error code. The most typical error is ERROR_CANCEL.
Remarks
The dialog does not store or validate the password except that a password is required and must match the verification field to continue.
While the title and description parameters are limited in number of characters, they are also limited in the available display size. The description is limited to displaying two lines of text. Return and other control characters are not allowed.
An example of the default operation:
Proper security precautions should be employed when storing and using passwords. This function abides by the Secure Memory Model.
Related Functions
Platform Support
Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL
Legato IDE, Legato Basic
| Table of Contents | < < Previous | Next >> |
© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.