IMAPIStatus::ChangePassword

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

Quick Info

See IMAPIStatus : IMAPIProp.

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.

See Also

PR_RESOURCE_METHODS