IMsTscNonScriptable::get_PortableSalt

  • Article

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

HRESULT get_PortableSalt(
  BSTR* pPortableSalt
);

Parameters

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

Return Values

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

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

See Also

IMsTscNonScriptable | put_PortableSalt

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.