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

See Also

Reference

IMsTscNonScriptable
IMsTscNonScriptable::put_BinarySalt