IMsTscNonScriptable::ResetPassword method

Resets all password states in the Remote Desktop ActiveX control. You can call this method to clear passwords that are stored in any one of the three supported formats: plaintext, portable encoded, or binary (nonportable) encoded. Note that encoded passwords should not be considered securely encrypted.

Syntax

HRESULT ResetPassword();

Parameters

This method has no parameters.

Return value

Return S_OK if successful.

Remarks

You can call this method to reset the control's password after disconnecting. This ensures that subsequent connections that use the same instance of the control do not automatically log on with a previously set password.

You can only call this method when the Remote Desktop ActiveX control is not in the connected state. This method returns E_FAIL if called when the control is connected. To check for the connected state, call the get_Connected method through the IMsTscAx interface or one of the interfaces that inherits from it.

For more information about Remote Desktop Web Connection, see Requirements for Remote Desktop Web Connection.

Requirements

Requirement Value
Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Type library
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsTscNonScriptable is defined as c1e6743a-41c1-4a74-832a-0dd06c1c7a0e

See also

IMsTscNonScriptable