IMsTscNonScriptable::get_BinarySalt
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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 |