IMAPIStatus::ChangePassword
Gilt für: Outlook 2013 | Outlook 2016
Ändert das Kennwort eines Dienstanbieters, ohne eine Benutzeroberfläche anzuzeigen. Diese Methode wird optional in status Von Dienstanbietern implementierten Objekten unterstützt.
HRESULT ChangePassword(
LPSTR lpOldPass,
LPSTR lpNewPass,
ULONG ulFlags
);
Parameter
lpOldPass
[in] Ein Zeiger auf das alte Kennwort.
lpNewPass
[in] Ein Zeiger auf das neue Kennwort.
ulFlags
[in] Eine Bitmaske von Flags, die das Format der Kennwörter steuert. Das folgende Flag kann festgelegt werden:
MAPI_UNICODE
Die Kennwörter liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Kennwörter im ANSI-Format vor.
Rückgabewert
S_OK
Die Kennwortänderung war erfolgreich.
MAPI_E_NO_ACCESS
Das alte Kennwort, auf das lpOldPass verweist, ist ungültig.
MAPI_E_NO_SUPPORT
Das status-Objekt unterstützt diesen Vorgang nicht, wie durch das Fehlen des STATUS_CHANGE_PASSWORD-Flags in der PR_RESOURCE_METHODS-Eigenschaft (PidTagResourceMethods) des status-Objekts angegeben.
Hinweise
Nicht alle status-Objekte unterstützen die IMAPIStatus::ChangePassword-Methode. Dies wird nur von Dienstanbietern unterstützt, die von Clients die Eingabe eines Kennworts verlangen. Keines der status Objekte, die MAPI implementiert, unterstützt den Vorgang zum Ändern des Kennworts.
ChangePassword ändert ein Kennwort programmgesteuert ohne Benutzerinteraktion.
Hinweise für Implementierer
Remotetransportanbieter implementieren ChangePassword wie hier angegeben. Es gibt keine besonderen Überlegungen.