PwdGetPasswordStatus

This function is used to retrieve information about a password provider's password. The request is passed to the network provider through the PPGetPasswordStatus SPI.


DWORD PwdGetPasswordStatus(
    LPCTSTR lpProvider,
    DWORD dwIndex,
    LPDWORD lpStatus,
    );

lpProvider

Specifies the network provider who owns the password.

dwIndex

Type of information to retrieve. Can be one of the following:

PS_ONOFF

Returns whether password is active or "turned on". Upon return, the following bits can be set in lpStatus: PS_ONOFF_ON, PS_ONOFF_OFF.

PS_HASOLDPWD

Returns whether it is necessary to supply the previous password in order to change the current password. Upon return, the following bits can be set in lpStatus: PS_HASOLDPWD_ON, PS_HAS_OLDPWD_OFF.

PS_SYNCMASTERPWD

Returns whether the password should be kept in sync with the logon password. Upon return, the following bits can be set in lpStatus: PS_SYNCMASTERPWD_ON, PS_SYNCMASTERPWD_OFF.

PS_STORAGETYPE

Returns whether the password is stored locally, or in a network location. Upon return, the following bits can be set in lpStatus: PS_STORAGETYPE_LOCAL, PS_STORAGETYPE_NETWORK.


lpStatus

A pointer to a bit field that is filled in upon return, based upon the value of the dwIndex field passed in. See the dwIndex field above for the possible values.