Share via

IMsTscNonScriptable::get_PortablePassword (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 portable encoded format.

Syntax

HRESULT get_PortablePassword(
  BSTR* pPortablePass
);

Parameters

  • pPortablePass
    [out] Pointer to a string that receives the password in portable-encoded format. This should not be considered a strongly encrypted format.

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 put_ClearTextPassword to set a password in clear-text format, you can then convert the password to portable encoded format by calling get_PortablePassword.

A portable encoded password consists of a portable password and a portable salt value, and appears as a string of hexadecimal digits.

To set a password in portable-encoded format, you must call both put_PortablePassword and put_PortableSalt.

You can call the get_PortableSalt method to retrieve the portable 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 pPortablePass. 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_PortablePassword
IMsTscNonScriptable::put_ClearTextPassword