IUserIdentity2::ChangePassword-Methode

[ChangePassword wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen Benutzerkonten mit schnellem Benutzerwechsel und Remotedesktop.]

Legt ein neues Kennwort für die Identität fest.

Syntax

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

Parameter

szOldPass [in]

Typ: WCHAR*

Die Breitzeichenzeichenfolge, die das Kennwort enthält, das derzeit der Identität zugeordnet ist.

szNewPass [in]

Typ: WCHAR*

Die Breitzeichenzeichenfolge, die das neue Kennwort enthält, das der Identität zugeordnet werden soll.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Der Wert von szOldPass muss mit dem aktuellen Kennwort der Identität übereinstimmen, damit szNewPass angewendet werden kann. Ein falscher Wert von szOldPass führt zu einem Rückgabewert von E_FAIL.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Ende des Supports (Client)	Windows 2000 Professional
Ende des Supports (Server)	Windows 2000 Server
Header	Msident.h
IDL	Msident.idl
DLL	Msident.dll