Edit

NET_VALIDATE_PERSISTED_FIELDS structure (lmaccess.h)

  • Article

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.

Value Meaning
NET_VALIDATE_PASSWORD_LAST_SET
 The PasswordLastSet member contains a new value.
NET_VALIDATE_BAD_PASSWORD_TIME
 The BadPasswordTime member contains a new value.
NET_VALIDATE_LOCKOUT_TIME
 The LockoutTime member contains a new value.
NET_VALIDATE_BAD_PASSWORD_COUNT
 The BadPasswordCount member contains a new value.
NET_VALIDATE_PASSWORD_HISTORY_LENGTH
 The PasswordHistoryLength member contains a new value.
NET_VALIDATE_PASSWORD_HISTORY
 The PasswordHistory member contains a new value.

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)

See also

NetValidatePasswordPolicy

Network Management Overview

Network Management Structures