IUserIdentity2::ChangePassword method

[ChangePassword is not supported and may be altered or unavailable in the future. Instead, use User Accounts with Fast User Switching and Remote Desktop.]

Sets a new password for the identity.

Syntax

HRESULT ChangePassword(
  [in] WCHAR *szOldPass,
  [in] WCHAR *szNewPass
);

Parameters

szOldPass [in]

Type: WCHAR*

The wide-character string that contains the password currently associated with the identity.

szNewPass [in]

Type: WCHAR*

The wide-character string that contains the new password to be associated with the identity.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The value of szOldPass must match the current password of the identity for szNewPass to be applied. An incorrect value of szOldPass will result in a return value of E_FAIL.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
End of client support
Windows 2000 Professional
End of server support
Windows 2000 Server
Header
Msident.h
IDL
Msident.idl
DLL
Msident.dll