Share via

IMsTscNonScriptable::get_BinaryPassword (Windows Embedded CE 6.0)

  • Article

1/6/2010

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

Syntax

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 Value

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 pBinaryPassword pCon. C/C++ applications must call the SysFreeString function to free the memory. This is not required for Visual Basic clients.

Requirements

Header discodlg.h, mstsax.idl
Library Mstsax.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IMsTscNonScriptable
IMsTscNonScriptable::put_BinaryPassword
IMsTscNonScriptable::put_ClearTextPassword