IMsTscNonScriptable::get_BinaryPassword

  • 项目

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

HRESULT get_BinaryPassword(
  BSTR* pBinaryPassword
);

Parameters

  • pBinaryPassword
    [out] Pointer to a string that receives the password part in binary-encoded format. This format should not be considered securely encrypted.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method returns a nonzero error code.

Remarks

If you first call the put_ClearTextPassword method to set a password in clear-text format, you can then convert the password to binary-encoded format by calling get_BinaryPassword.

A binary-encoded password consists of a binary password and a binary salt value. It is not in a human-readable format.

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

You can call the get_BinarySalt method to retrieve the binary salt part of the password.

For more information about converting clear-text passwords to encoded passwords, see the put_ClearTextPassword method.

This method allocates the memory for the buffer pointed to by pBinaryPasswordpCon. C/C++ applications must call the SysFreeString function to free the memory. This is not required for Visual Basic clients.

Requirements

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

See Also

IMsTscNonScriptable | put_BinaryPassword | put_ClearTextPassword

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.