Share via


IMsTscNonScriptable::get_BinarySalt (Windows Embedded CE 6.0)

1/6/2010

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

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

Syntax

HRESULT get_BinarySalt(
  BSTR* pSalt
);

Parameters

  • pSalt
    [out] Pointer to a string that receives the salt-value part of a binary-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

A binary-encoded (nonportable) password consists of an encoded binary password and an encoded binary salt value. Binary-encoded passwords do not appear in human-readable format and can be used only by the same user, and on the same machine where the password was encrypted. Binary-encoded passwords should not be considered strongly encrypted.

To retrieve the binary password part of the password, call the get_BinaryPassword method.

This method allocates the memory for the buffer pointed to by pSalt. C/C++ applications must call the SysFreeString functionto 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_BinarySalt