estructura USER_INFO_11 (lmaccess.h)
La estructura de USER_INFO_11 contiene información sobre una cuenta de usuario, incluido el nombre de la cuenta, el nivel de privilegio, la ruta de acceso al directorio principal del usuario y otras estadísticas de red relacionadas con el usuario.
Sintaxis
typedef struct _USER_INFO_11 {
LPWSTR usri11_name;
LPWSTR usri11_comment;
LPWSTR usri11_usr_comment;
LPWSTR usri11_full_name;
DWORD usri11_priv;
DWORD usri11_auth_flags;
DWORD usri11_password_age;
LPWSTR usri11_home_dir;
LPWSTR usri11_parms;
DWORD usri11_last_logon;
DWORD usri11_last_logoff;
DWORD usri11_bad_pw_count;
DWORD usri11_num_logons;
LPWSTR usri11_logon_server;
DWORD usri11_country_code;
LPWSTR usri11_workstations;
DWORD usri11_max_storage;
DWORD usri11_units_per_week;
PBYTE usri11_logon_hours;
DWORD usri11_code_page;
} USER_INFO_11, *PUSER_INFO_11, *LPUSER_INFO_11;
Miembros
usri11_name
Tipo: LPWSTR
Puntero a un carácter Unicode que especifica el nombre de la cuenta de usuario. Las llamadas a la función NetUserSetInfo omiten este miembro. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
usri11_comment
Tipo: LPWSTR
Puntero a una cadena Unicode que contiene un comentario asociado a la cuenta de usuario. Esta cadena puede ser una cadena NULL o puede tener cualquier número de caracteres antes de terminar el carácter NULO.
usri11_usr_comment
Tipo: LPWSTR
Puntero a una cadena Unicode que contiene un comentario de usuario. Esta cadena puede ser una cadena NULL o puede tener cualquier número de caracteres antes de terminar el carácter NULO.
usri11_full_name
Tipo: LPWSTR
Puntero a una cadena Unicode que contiene el nombre completo del usuario. Esta cadena puede ser una cadena NULL o puede tener cualquier número de caracteres antes de terminar el carácter NULO.
usri11_priv
Tipo: DWORD
Nivel de privilegio asignado al miembro usri11_name . Para las llamadas a la función NetUserAdd , este miembro debe ser USER_PRIV_USER. Para las llamadas a NetUserSetInfo, este miembro debe ser el valor devuelto por la función NetUserGetInfo o la función NetUserEnum . Este miembro puede ser uno de los valores siguientes. Para obtener más información sobre los derechos de cuenta de usuario y grupo, consulte Privilegios.
| Valor | Significado |
|---|---|
|
Invitado |
|
Usuario |
|
Administrador |
usri11_auth_flags
Tipo: DWORD
Conjunto de marcas de bits que definen los privilegios de operador del usuario.
Las llamadas a la función NetUserGetInfo y a la función NetUserEnum devuelven un valor basado en la pertenencia al grupo local del usuario. Si el usuario es miembro de operadores de impresión, se establece AF_OP_PRINT. Si el usuario es miembro de los operadores de servidor, se establece AF_OP_SERVER. Si el usuario es miembro de los operadores de cuenta, se establece AF_OP_ACCOUNTS. AF_OP_COMM nunca se establece.
Las funciones NetUserAdd y NetUserSetInfo omiten este miembro.
Se aplican las restricciones que se indican a continuación:
- Al llamar a la función NetUserAdd , este miembro debe ser cero.
- Cuando se llama a la función NetUserSetInfo , este miembro debe ser el valor devuelto desde una llamada a NetUserGetInfo o a NetUserEnum.
usri11_password_age
Tipo: DWORD
Número de segundos transcurridos desde que se cambió por última vez el miembro de usri11_password . Las funciones NetUserAdd y NetUserSetInfo omiten este miembro.
usri11_home_dir
Tipo: LPWSTR
Puntero a una cadena Unicode que especifica la ruta de acceso del directorio principal para el usuario especificado en el miembro usri11_name . La cadena puede ser NULL.
usri11_parms
Tipo: LPWSTR
Puntero a una cadena Unicode que está reservada para su uso por parte de las aplicaciones. Esta cadena puede ser una cadena NULL o puede tener cualquier número de caracteres antes de terminar el carácter NULO. Los productos de Microsoft usan este miembro para almacenar información de configuración de usuario. No modifique esta información.
usri11_last_logon
Tipo: DWORD
Fecha y hora en que se produjo el último inicio de sesión. Este valor se almacena como el número de segundos transcurridos desde las 00:00:00, 1 de enero de 1970, GMT. Las funciones NetUserAdd y NetUserSetInfo omiten este miembro.
Este miembro se mantiene por separado en cada controlador de dominio de copia de seguridad (BDC) del dominio. Para obtener un valor preciso, debe consultar cada BDC en el dominio. El último inicio de sesión se produjo en el momento indicado por el valor recuperado más grande.
usri11_last_logoff
Tipo: DWORD
Este miembro no se usa actualmente.
Fecha y hora en que se produjo el último inicio de sesión. Este valor se almacena como el número de segundos transcurridos desde las 00:00:00, 1 de enero de 1970, GMT. Un valor de cero indica que se desconoce la última hora de cierre de sesión. La función NetUserAdd y la función NetUserSetInfo omiten este miembro.
Este miembro se mantiene por separado en cada controlador de dominio de copia de seguridad (BDC) del dominio. Para obtener un valor preciso, debe consultar cada BDC en el dominio. El último inicio de sesión se produjo en el momento indicado por el valor recuperado más grande.
usri11_bad_pw_count
Tipo: DWORD
Número de veces que el usuario intentó iniciar sesión en esta cuenta con una contraseña incorrecta. Un valor de – 1 indica que el valor es desconocido. Las funciones NetUserAdd y NetUserSetInfo omiten este miembro.
Este miembro se replica desde el controlador de dominio principal (PDC); también se mantiene en cada controlador de dominio de copia de seguridad (BDC) del dominio. Para obtener un valor preciso, debe consultar cada BDC en el dominio. El número de veces que el usuario intentó iniciar sesión con una contraseña incorrecta es el valor más grande recuperado.
usri11_num_logons
Tipo: DWORD
Número de veces que el usuario ha iniciado sesión correctamente en esta cuenta. Un valor de – 1 indica que el valor es desconocido. Las llamadas a las funciones NetUserAdd y NetUserSetInfo omiten este miembro.
Este miembro se mantiene por separado en cada controlador de dominio de copia de seguridad (BDC) del dominio. Para obtener un valor preciso, debe consultar cada BDC en el dominio. El número de veces que el usuario ha iniciado sesión correctamente es la suma de los valores recuperados.
usri11_logon_server
Tipo: LPWSTR
Puntero a una cadena Unicode que contiene el nombre del servidor al que se envían las solicitudes de inicio de sesión. Los nombres de servidor deben ir precedidos de dos barras diagonales inversas (\). Para indicar que cualquier servidor de inicio de sesión puede controlar la solicitud de inicio de sesión, especifique un asterisco (\*) para el nombre del servidor. Una cadena NULL indica que las solicitudes se deben enviar al controlador de dominio.
Para servidores Windows, NetUserGetInfo y NetUserEnum devuelven \*. Las funciones NetUserAdd y NetUserSetInfo omiten este miembro.
usri11_country_code
Tipo: DWORD
Código de país o región para el idioma que prefiera el usuario.
usri11_workstations
Tipo: LPWSTR
Puntero a una cadena Unicode que contiene los nombres de las estaciones de trabajo desde las que el usuario puede iniciar sesión. Se pueden especificar hasta ocho estaciones de trabajo; los nombres deben estar separados por comas. Una cadena NULL indica que no hay ninguna restricción. Para deshabilitar los inicios de sesión de todas las estaciones de trabajo en esta cuenta, establezca el valor de UF_ACCOUNTDISABLE en el miembro usri11_flags .
usri11_max_storage
Tipo: DWORD
Cantidad máxima de espacio en disco que puede usar el usuario. Especifique USER_MAXSTORAGE_UNLIMITED para usar todo el espacio disponible en disco.
usri11_units_per_week
Tipo: DWORD
Número de unidades de tiempo de igual duración en las que se divide la semana. Este valor es necesario para calcular la longitud de la cadena de bits en el miembro usri11_logon_hours .
Este miembro debe ser UNITS_PER_WEEK para LAN Manager 2.0. Las funciones NetUserAdd y NetUserSetInfo omiten este elemento.
En el caso de las aplicaciones de servicio, las unidades deben ser uno de los siguientes valores: SAM_DAYS_PER_WEEK, SAM_HOURS_PER_WEEK o SAM_MINUTES_PER_WEEK.
usri11_logon_hours
Tipo: PBYTE
Puntero a una cadena de bits de 21 bytes (168 bits) que especifica las horas durante las que el usuario puede iniciar sesión. Cada bit representa una hora única en la semana, en hora media de Greenwich (GMT).
El primer bit (bit 0, palabra 0) es domingo, de 0:00 a 0:59; el segundo bit (bit 1, palabra 0) es domingo, de 1:00 a 1:59; y así sucesivamente. Tenga en cuenta que el bit 0 de la palabra 0 representa el domingo de 0:00 a 0:59 solo si se encuentra en la zona horaria GMT. En todos los demás casos, debe ajustar los bits según el desplazamiento de la zona horaria (por ejemplo, GMT menos 8 horas para la hora estándar del Pacífico).
Especifique un puntero NULL en este miembro al llamar a la función NetUserAdd para indicar ninguna restricción de tiempo. Especifique un puntero NULL al llamar a la función NetUserSetInfo para indicar que no se realizará ningún cambio en las horas durante las que el usuario pueda iniciar sesión.
usri11_code_page
Tipo: DWORD
Página de códigos del idioma que prefiera el usuario.
Comentarios
Los nombres de cuenta de usuario están limitados a 20 caracteres y los nombres de grupo están limitados a 256 caracteres. Además, los nombres de cuenta no se pueden terminar por un punto y no pueden incluir comas ni ninguno de los siguientes caracteres imprimibles: ", /, , [, ], :, |, <, >, +, =, ;, ?, *. Los nombres tampoco pueden incluir caracteres en el intervalo 1-31, que no son imprimibles.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | lmaccess.h (include Lm.h) |
Consulte también
Introducción a la administración de redes