Compartilhar via


IMsTscNonScriptable::get_BinarySalt (Windows CE 5.0)

Send Feedback

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.

HRESULT get_BinarySalt(BSTR* pSalt);

Parameters

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

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 function to free the memory. 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_BinarySalt

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.