IMAPIStatus::ChangePassword

The IMAPIStatus::ChangePassword method modifies a service provider's password without displaying a user interface.

Quick Info

HRESULT ChangePassword(
  LPTSTR lpOldPass,   
  LPTSTR lpNewPass,   
  ULONG ulFlags       
);

Parameters

lpOldPass

[in] Pointer to the old password.

lpNewPass

[in] Pointer to the new password.

ulFlags

[in] 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.

Return Values

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 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 implemented by MAPI 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.