NET_VALIDATE_PERSISTED_FIELDS structure (lmaccess.h)
The NET_VALIDATE_PERSISTED_FIELDS structure contains information about a user's password properties. Input to and output from the NetValidatePasswordPolicy function contain persistent password-related data. When the function outputs this structure, it identifies the persistent data that has changed in this call.
Syntax
typedef struct _NET_VALIDATE_PERSISTED_FIELDS {
ULONG PresentFields;
FILETIME PasswordLastSet;
FILETIME BadPasswordTime;
FILETIME LockoutTime;
ULONG BadPasswordCount;
ULONG PasswordHistoryLength;
PNET_VALIDATE_PASSWORD_HASH PasswordHistory;
} NET_VALIDATE_PERSISTED_FIELDS, *PNET_VALIDATE_PERSISTED_FIELDS;
Members
PresentFields
Type: ULONG
A set of bit flags identifying the persistent password-related data that has changed. This member is valid only when this structure is output from the NetValidatePasswordPolicy function. This member is ignored when this structure is input to the function. For more information, see the following Remarks section.
PasswordLastSet
Type: FILETIME
The date and time (in GMT) when the password for the account was set or last changed.
BadPasswordTime
Type: FILETIME
The date and time (in GMT) when the user tried to log on to the account using an incorrect password.
LockoutTime
Type: FILETIME
The date and time (in GMT) when the account was last locked out. If the account has not been locked out, this member is zero. A lockout occurs when the number of bad password logins exceeds the number allowed.
BadPasswordCount
Type: ULONG
The number of times the user tried to log on to the account using an incorrect password.
PasswordHistoryLength
Type: ULONG
The number of previous passwords saved in the history list for the account. The user cannot reuse a password in the history list.
PasswordHistory
Type: PNET_VALIDATE_PASSWORD_HASH
A pointer to a NET_VALIDATE_PASSWORD_HASH structure that contains the password hashes in the history list.
Remarks
Note that it is the application's responsibility to save all changed persistent data as well as any user object information. The next time the application calls NetValidatePasswordPolicy on the same instance of the user object, the application must provide the required fields from the persistent information.
The NET_VALIDATE_AUTHENTICATION_INPUT_ARG, NET_VALIDATE_PASSWORD_CHANGE_INPUT_ARG, NET_VALIDATE_PASSWORD_RESET_INPUT_ARG, and NET_VALIDATE_OUTPUT_ARG structures contain a NET_VALIDATE_PERSISTED_FIELDS structure.
Requirements
Requirement | Value |
---|---|
Minimum supported client | None supported |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Header | lmaccess.h (include Lm.h) |