PPChangePassword

This function is used to inform the password provider that the user wishes to change the password for this provider.


DWORD PPChangePassword(
LPLOGONINFO lpAuthentInfo,
LPLOGONINFO lpPreviousAuthentInfo
DWORD dwAction
    );

lpAuthentInfo

A structure specifying the logged-on user's name and new password.

lpPreviousAuthentInfo

A structure specifying the user's name and old password.

dwAction

One of the following values:

PWDCHANGE_MASTERPWD_NOTIFY

The Windows password has changed. The provider may wish to take some action, such as giving the new password to a network redirector.

PWDCHANGE_PROVIDERPWD_PENDING

The user wants to change a password maintained by the provider. This message is a first-phase notification. The provider should not change the password at this time. The provider should do any pre-commit verification that is appropriate, such as pinging a server or checking that the old password is valid, if possible.

PWDCHANGE_PROVIDERPWD_COMMIT

Commit-phase notification, the provider should change the password in response to this message.

PWDCHANGE_PROVIDERPWD_CANCEL

A provider will receive this message if it has already received a first-phase notification (PWDCHANGE_PROVIDERPWD_ PENDING) and the password-change action has been canceled (for example, in response to another provider being unable to change its password).