IMAPIStatus::ChangePassword
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Modifies a service provider's password without displaying a user interface. This method is optionally supported in status objects that service providers implement.
HRESULT ChangePassword(
LPSTR lpOldPass,
LPSTR lpNewPass,
ULONG ulFlags
);
Parameters
lpOldPass
[in] A pointer to the old password.lpNewPass
[in] A pointer to the new password.ulFlags
[in] A bitmask of flags that controls the format of the passwords. The following flag can be set:- MAPI_UNICODE
The passwords are in Unicode format. If the MAPI_UNICODE flag is not set, the passwords are in ANSI format.
- MAPI_UNICODE
Return Value
S_OK
The password modification was successful.MAPI_E_NO_ACCESS
The old password pointed to by lpOldPass is invalid.MAPI_E_NO_SUPPORT
The status object does not support this operation, as indicated by the absence of the STATUS_CHANGE_PASSWORD flag in the status object's PR_RESOURCE_METHODS (PidTagResourceMethods) property.
Remarks
Not all status objects support the IMAPIStatus::ChangePassword method. It is supported only by service providers that require clients to enter a password. None of the status objects that MAPI implements support the password change operation.
ChangePassword modifies a password programmatically, without user interaction.
Notes to Implementers
Remote transport providers implement ChangePassword as specified here. There are no special considerations.