IMAPIStatus::ChangePassword

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

Quick Info

See IMAPIStatus : IMAPIPropL2ZHF1.

 

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_METHODS1BJ9KZ4 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.

See Also

PR_RESOURCE_METHODS