estructura USER_INFO_11 (lmaccess.h)

Artículo
03/09/2023

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
USER_PRIV_GUEST	Invitado
USER_PRIV_USER	Usuario
USER_PRIV_ADMIN	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.

Este miembro puede ser uno o varios de los valores siguientes.

Valor	Significado
AF_OP_PRINT	El privilegio del operador de impresión está habilitado.
AF_OP_COMM	El privilegio del operador de comunicaciones está habilitado.
AF_OP_SERVER	El privilegio del operador de servidor está habilitado.
AF_OP_ACCOUNTS	El privilegio del operador accounts está habilitado.

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.

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)