IMsTscNonScriptable::get_PortablePassword
Other versions of this page are also available for the following:
8/28/2008
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