NET_VALIDATE_OUTPUT_ARG
TOC
Collapse the table of content
Expand the table of content

NET_VALIDATE_OUTPUT_ARG structure

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_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.

ValueMeaning
NERR_AccountLockedOutValidation failed. The account is locked out.
NERR_PasswordMustChangeValidation failed. The password must change at the next logon.
NERR_PasswordExpiredValidation failed. The password has expired.
NERR_BadPasswordValidation failed. The password is invalid.
NERR_SuccessThe 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.

ValueMeaning
NERR_AccountLockedOutValidation failed. The account is locked out.
NERR_PasswordTooRecentValidation failed. The password for the user is too recent to change.
NERR_BadPasswordValidation failed. The password is invalid.
NERR_PasswordHistConflictValidation failed. The password cannot be used at this time.
NERR_PasswordTooShortValidation failed. The password does not meet policy requirements because it is too short.
NERR_PasswordTooLongValidation failed. The password does not meet policy requirements because it is too long.
NERR_PasswordNotComplexEnoughValidation failed. The password does not meet policy requirements because it is not complex enough.
NERR_PasswordFilterErrorValidation failed. The password does not meet the requirements of the password filter DLL.
NERR_SuccessThe 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.

ValueMeaning
NERR_PasswordTooShortValidation failed. The password does not meet policy requirements because it is too short.
NERR_PasswordTooLongValidation failed. The password does not meet policy requirements because it is too long.
NERR_PasswordNotComplexEnoughValidation failed. The password does not meet policy requirements because it is not complex enough.
NERR_PasswordFilterErrorValidation failed. The password does not meet the requirements of the password filter DLL.
NERR_SuccessThe 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

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Lmaccess.h (include Lm.h)

See also

Network Management Overview
Network Management Structures
NetValidatePasswordPolicy

 

 

Show:
© 2016 Microsoft