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.