IMsTscNonScriptable::put_BinaryPassword

  • Article

This method sets the password part of a connection password for the Remote Desktop ActiveX control, in binary (nonportable) encoded format.

HRESULT put_BinaryPassword(
  BSTR newPassword
);

Parameters

  • newPassword
    [in] String with password part, specified in binary-encoded format.

Return Values

The following table shows the return values for this method.

Value Description
S_OK Password was correctly set.
E_FAIL The control is already connected or in the connecting state.
nonzero error code An error occurred.

Remarks

You can also call this method to specify the password part of a connection password after you first call put_ClearTextPassword and then get_BinaryPassword to convert the password.

A binary-encoded (nonportable) password consists of an encoded binary password and an encoded binary salt value. Binary-encoded passwords do not appear in human-readable format and can be used only by the same user, and on the same machine where the password was encrypted. Binary-encoded passwords should not be considered strongly encrypted.

To set a password in binary-encoded format, you must call both put_BinaryPassword and put_BinarySalt.

This property can be set only if the control is not in the connected state. The method returns E_FAIL if called when the control is connected. You can check if the control is connected by calling the IMsTscAx::get_Connected method.

To enable automatic logon, you must also set the UserName, Domain, and BinarySalt properties. If the password fails to authenticate the user, the Windows logon dialog box is displayed at the server to prompt the user for the password.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Discodlg.h. Mstsax.idl.
Link Library: Mstsax.lib.

See Also

IMsTscNonScriptable | get_BinaryPassword

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.