NET_VALIDATE_OUTPUT_ARG structure (lmaccess.h)
The NET_VALIDATE_OUTPUT_ARG structure contains information about persistent password-related data that has changed since the user's last logon as well as the result of the function's password validation check.
Syntax
typedef struct _NET_VALIDATE_OUTPUT_ARG {
NET_VALIDATE_PERSISTED_FIELDS ChangedPersistedFields;
NET_API_STATUS ValidationStatus;
} NET_VALIDATE_OUTPUT_ARG, *PNET_VALIDATE_OUTPUT_ARG;
Members
ChangedPersistedFields
A structure that contains changes to persistent information about the account being logged on. For more information, see the following Remarks section.
ValidationStatus
The result of the password validation check performed by the NetValidatePasswordPolicy function. The status depends on the value specified in the ValidationType parameter to that function.
Authentication. When you call NetValidatePasswordPolicy and specify the ValidationType parameter as NetValidateAuthentication, this member can be one of the following values.
| Value | Meaning |
|---|---|
| NERR_AccountLockedOut | Validation failed. The account is locked out. |
| NERR_PasswordMustChange | Validation failed. The password must change at the next logon. |
| NERR_PasswordExpired | Validation failed. The password has expired. |
| NERR_BadPassword | Validation failed. The password is invalid. |
| NERR_Success | The password passes the validation check. |
Password change. When you call NetValidatePasswordPolicy and specify the ValidationType parameter as NetValidatePasswordChange, this member can be one of the following values.
| Value | Meaning |
|---|---|
| NERR_AccountLockedOut | Validation failed. The account is locked out. |
| NERR_PasswordTooRecent | Validation failed. The password for the user is too recent to change. |
| NERR_BadPassword | Validation failed. The password is invalid. |
| NERR_PasswordHistConflict | Validation failed. The password cannot be used at this time. |
| NERR_PasswordTooShort | Validation failed. The password does not meet policy requirements because it is too short. |
| NERR_PasswordTooLong | Validation failed. The password does not meet policy requirements because it is too long. |
| NERR_PasswordNotComplexEnough | Validation failed. The password does not meet policy requirements because it is not complex enough. |
| NERR_PasswordFilterError | Validation failed. The password does not meet the requirements of the password filter DLL. |
| NERR_Success | The password passes the validation check. |
Password reset. When you call NetValidatePasswordPolicy and specify the ValidationType parameter as NetValidatePasswordReset, this member can be one of the following values.
| Value | Meaning |
|---|---|
| NERR_PasswordTooShort | Validation failed. The password does not meet policy requirements because it is too short. |
| NERR_PasswordTooLong | Validation failed. The password does not meet policy requirements because it is too long. |
| NERR_PasswordNotComplexEnough | Validation failed. The password does not meet policy requirements because it is not complex enough. |
| NERR_PasswordFilterError | Validation failed. The password does not meet the requirements of the password filter DLL. |
| NERR_Success | The password passes the validation check. |
Remarks
The NetValidatePasswordPolicy function outputs the NET_VALIDATE_OUTPUT_ARG structure.
Note that it is the application's responsibility to save all the data in the ChangedPersistedFields member of the NET_VALIDATE_OUTPUT_ARG structure 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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Header | lmaccess.h (include Lm.h) |