estructura NET_VALIDATE_PERSISTED_FIELDS (lmaccess.h)
La estructura NET_VALIDATE_PERSISTED_FIELDS contiene información sobre las propiedades de contraseña de un usuario. La entrada y salida de la función NetValidatePasswordPolicy contiene datos persistentes relacionados con la contraseña. Cuando la función genera esta estructura, identifica los datos persistentes que han cambiado en esta llamada.
Sintaxis
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;
Miembros
PresentFields
Tipo: ULONG
Un conjunto de marcas de bits que identifican los datos persistentes relacionados con la contraseña que han cambiado. Este miembro solo es válido cuando esta estructura se genera desde la función NetValidatePasswordPolicy . Este miembro se omite cuando esta estructura se introduce en la función. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
PasswordLastSet
Tipo: FILETIME
Fecha y hora (en GMT) cuando se estableció o cambió por última vez la contraseña de la cuenta.
BadPasswordTime
Tipo: FILETIME
Fecha y hora (en GMT) cuando el usuario intentó iniciar sesión en la cuenta con una contraseña incorrecta.
LockoutTime
Tipo: FILETIME
Fecha y hora (en GMT) cuando la cuenta se bloqueó por última vez. Si la cuenta no se ha bloqueado, este miembro es cero. Un bloqueo se produce cuando el número de inicios de sesión con contraseña incorrecta supera el número permitido.
BadPasswordCount
Tipo: ULONG
Número de veces que el usuario intentó iniciar sesión en la cuenta con una contraseña incorrecta.
PasswordHistoryLength
Tipo: ULONG
Número de contraseñas anteriores guardadas en la lista de historial de la cuenta. El usuario no puede reutilizar una contraseña en la lista de historial.
PasswordHistory
Tipo: PNET_VALIDATE_PASSWORD_HASH
Puntero a una estructura de NET_VALIDATE_PASSWORD_HASH que contiene los hashes de contraseña en la lista de historial.
Comentarios
Tenga en cuenta que es responsabilidad de la aplicación guardar todos los datos persistentes modificados, así como cualquier información de objeto de usuario. La próxima vez que la aplicación llame a NetValidatePasswordPolicy en la misma instancia del objeto de usuario, la aplicación debe proporcionar los campos necesarios de la información persistente.
Las estructuras NET_VALIDATE_AUTHENTICATION_INPUT_ARG, NET_VALIDATE_PASSWORD_CHANGE_INPUT_ARG, NET_VALIDATE_PASSWORD_RESET_INPUT_ARG y NET_VALIDATE_OUTPUT_ARG contienen una estructura de NET_VALIDATE_PERSISTED_FIELDS .
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | No se admite ninguno |
Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
Encabezado | lmaccess.h (include Lm.h) |