Programming with Reflection

$image\rwnprg32.gif$ GetPassword method

Syntax EncodedPassword = object.GetPassword([Prompt], [HostUserName], [HostName], [Options])

Description

Opens a dialog box that prompts for a password. The value entered in this dialog box is returned.

Arguments

Prompt Argument type: String
Optional
Specifies the prompt text for the dialog box. If this argument is omitted, the default value is "Password for <HostUserName> on <HostName:>" when HostUserName is specified. The default is "Password for <HostName>" if no HostUserName is specified. The default is "Password:" if no host is configured.

HostUserName Argument type: String
Optional
Specifies a host user name.

HostName Argument type: String
Optional
Specifies a host name. If this argument is omitted, GetPassword uses the hostname from the current connection information.

Options Optional
Omit this argument; it is not currently used.

Return

EncodedPassword Return type: String
The password returned from the dialog box. The password is returned in an encoded form. To transmit an encoded password to the host, use the Transmit method with the rcDecodePassword option.

An null string indicates a null password, a missing password, or the user selecting cancel in a dialog box.

$image\jump.gif$ Keyword Index

$image\popup.gif$ Related Topics

$image\popup.gif$ Reflection products that use this command