Share via


IMsTscNonScriptable::get_PortableSalt (Windows Embedded CE 6.0)

1/6/2010

This method retrieves the salt value part of the Remote Desktop ActiveX control's portable encoded password.

Syntax

HRESULT get_PortableSalt(
  BSTR* pPortableSalt
);

Parameters

  • pPortableSalt
    [out] Pointer to a string that receives the salt value part of a portable encoded password.

Return Value

If the method succeeds, the return value is S_OK.

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

Remarks

You can also call this method to retrieve a password's portable salt value after you set the password in clear-text format with a call to put_ClearTextPassword.

A portable encoded password consists of a portable password part and a portable salt value part, 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.

To retrieve the portable password part of a password, call the get_PortablePassword method.

This method allocates the memory required for the buffer pointed to by the pPortableSalt parameter. Calling C/C++ applications must free the memory with a call to the SysFreeString function. 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_PortableSalt