USER_INFO_11 structure (lmaccess.h)

Article
08/24/2023

La structure USER_INFO_11 contient des informations sur un compte d’utilisateur, notamment le nom du compte, le niveau de privilège, le chemin d’accès au répertoire de base de l’utilisateur et d’autres statistiques réseau relatives à l’utilisateur.

Syntaxe

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;

Membres

usri11_name

Type : LPWSTR

Pointeur vers un caractère Unicode qui spécifie le nom du compte d’utilisateur. Les appels à la fonction NetUserSetInfo ignorent ce membre. Pour plus d'informations, consultez la section Notes qui suit.

usri11_comment

Type : LPWSTR

Pointeur vers une chaîne Unicode qui contient un commentaire associé au compte d’utilisateur. Cette chaîne peut être une chaîne NULL ou avoir un nombre quelconque de caractères avant le caractère null de fin.

usri11_usr_comment

Type : LPWSTR

Pointeur vers une chaîne Unicode qui contient un commentaire utilisateur. Cette chaîne peut être une chaîne NULL ou avoir un nombre quelconque de caractères avant le caractère null de fin.

usri11_full_name

Type : LPWSTR

Pointeur vers une chaîne Unicode qui contient le nom complet de l’utilisateur. Cette chaîne peut être une chaîne NULL ou avoir un nombre quelconque de caractères avant le caractère null de fin.

usri11_priv

Type : DWORD

Niveau de privilège attribué au membre usri11_name . Pour les appels à la fonction NetUserAdd , ce membre doit être USER_PRIV_USER. Pour les appels à NetUserSetInfo, ce membre doit être la valeur retournée par la fonction NetUserGetInfo ou la fonction NetUserEnum . Ce membre peut être l’une des valeurs suivantes. Pour plus d’informations sur les droits de compte d’utilisateur et de groupe, consultez Privilèges.

Valeur	Signification
USER_PRIV_GUEST	Invité
USER_PRIV_USER	Utilisateur
USER_PRIV_ADMIN	Administrateur

usri11_auth_flags

Type : DWORD

Ensemble d’indicateurs de bits définissant les privilèges d’opérateur de l’utilisateur.

Les appels à la fonction NetUserGetInfo et à la fonction NetUserEnum retournent une valeur basée sur l’appartenance au groupe local de l’utilisateur. Si l’utilisateur est membre des opérateurs d’impression, AF_OP_PRINT est défini. Si l’utilisateur est membre des opérateurs de serveur, AF_OP_SERVER est défini. Si l’utilisateur est membre des opérateurs de compte, AF_OP_ACCOUNTS est défini. AF_OP_COMM n’est jamais défini.

Les fonctions NetUserAdd et NetUserSetInfo ignorent ce membre.

Les restrictions suivantes s’appliquent :

Lorsque vous appelez la fonction NetUserAdd , ce membre doit être égal à zéro.
Lorsque vous appelez la fonction NetUserSetInfo , ce membre doit être la valeur retournée par un appel à NetUserGetInfo ou à NetUserEnum.

Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
AF_OP_PRINT	Le privilège de l’opérateur d’impression est activé.
AF_OP_COMM	Le privilège de l’opérateur de communication est activé.
AF_OP_SERVER	Le privilège de l’opérateur de serveur est activé.
AF_OP_ACCOUNTS	Le privilège de l’opérateur de comptes est activé.

usri11_password_age

Type : DWORD

Nombre de secondes écoulées depuis la dernière modification du membre usri11_password . Les fonctions NetUserAdd et NetUserSetInfo ignorent ce membre.

usri11_home_dir

Type : LPWSTR

Pointeur vers une chaîne Unicode spécifiant le chemin du répertoire de base de l’utilisateur spécifié dans le membre usri11_name . La chaîne peut être NULL.

usri11_parms

Type : LPWSTR

Pointeur vers une chaîne Unicode réservée aux applications. Cette chaîne peut être une chaîne NULL ou avoir un nombre quelconque de caractères avant le caractère null de fin. Les produits Microsoft utilisent ce membre pour stocker les informations de configuration utilisateur. Ne modifiez pas ces informations.

usri11_last_logon

Type : DWORD

Date et heure de la dernière ouverture de session. Cette valeur est stockée sous la forme du nombre de secondes écoulées depuis 00 :00 :00, le 1er janvier 1970, GMT. Les fonctions NetUserAdd et NetUserSetInfo ignorent ce membre.

Ce membre est géré séparément sur chaque contrôleur de domaine de sauvegarde (BDC) du domaine. Pour obtenir une valeur précise, vous devez interroger chaque BDC dans le domaine. La dernière ouverture de session s’est produite à l’heure indiquée par la plus grande valeur récupérée.

usri11_last_logoff

Type : DWORD

Ce membre n’est actuellement pas utilisé.

Date et heure de la dernière déconnexion. Cette valeur est stockée sous la forme du nombre de secondes écoulées depuis 00 :00 :00, le 1er janvier 1970, GMT. La valeur zéro indique que l’heure de la dernière déconnexion est inconnue. Les fonctions NetUserAdd et NetUserSetInfo ignorent ce membre.

Ce membre est géré séparément sur chaque contrôleur de domaine de sauvegarde (BDC) du domaine. Pour obtenir une valeur précise, vous devez interroger chaque BDC dans le domaine. La dernière déconnexion s’est produite à l’heure indiquée par la plus grande valeur récupérée.

usri11_bad_pw_count

Type : DWORD

Nombre de fois que l’utilisateur a tenté de se connecter à ce compte à l’aide d’un mot de passe incorrect. La valeur – 1 indique que la valeur est inconnue. Les fonctions NetUserAdd et NetUserSetInfo ignorent ce membre.

Ce membre est répliqué à partir du contrôleur de domaine principal (PDC) ; il est également conservé sur chaque contrôleur de domaine de sauvegarde (BDC) dans le domaine. Pour obtenir une valeur précise, vous devez interroger chaque BDC dans le domaine. Le nombre de fois où l’utilisateur a tenté de se connecter à l’aide d’un mot de passe incorrect est la valeur la plus élevée récupérée.

usri11_num_logons

Type : DWORD

Nombre de fois que l’utilisateur s’est connecté avec succès à ce compte. La valeur – 1 indique que la valeur est inconnue. Les appels aux fonctions NetUserAdd et NetUserSetInfo ignorent ce membre.

Ce membre est géré séparément sur chaque contrôleur de domaine de sauvegarde (BDC) du domaine. Pour obtenir une valeur précise, vous devez interroger chaque BDC dans le domaine. Le nombre de fois que l’utilisateur s’est connecté avec succès correspond à la somme des valeurs récupérées.

usri11_logon_server

Type : LPWSTR

Pointeur vers une chaîne Unicode qui contient le nom du serveur auquel les demandes d’ouverture de session sont envoyées. Les noms de serveur doivent être précédés de deux barres obliques inverses (\). Pour indiquer que la demande d’ouverture de session peut être gérée par n’importe quel serveur d’ouverture de session, spécifiez un astérisque (\*) pour le nom du serveur. Une chaîne NULL indique que les demandes doivent être envoyées au contrôleur de domaine.

Pour les serveurs Windows, NetUserGetInfo et NetUserEnum retournent \*. Les fonctions NetUserAdd et NetUserSetInfo ignorent ce membre.

usri11_country_code

Type : DWORD

Code du pays/de la région de la langue de choix de l’utilisateur.

usri11_workstations

Type : LPWSTR

Pointeur vers une chaîne Unicode qui contient les noms des stations de travail à partir desquelles l’utilisateur peut se connecter. Huit stations de travail peuvent être spécifiées ; les noms doivent être séparés par des virgules. Une chaîne NULL indique qu’il n’existe aucune restriction. Pour désactiver les connexions de toutes les stations de travail à ce compte, définissez la valeur UF_ACCOUNTDISABLE dans le membre usri11_flags .

usri11_max_storage

Type : DWORD

Quantité maximale d’espace disque que l’utilisateur peut utiliser. Spécifiez USER_MAXSTORAGE_UNLIMITED utiliser tout l’espace disque disponible.

usri11_units_per_week

Type : DWORD

Nombre d’unités de temps de durée égale dans lesquelles la semaine est divisée. Cette valeur est nécessaire pour calculer la longueur de la chaîne de bits dans le membre usri11_logon_hours .

Ce membre doit être UNITS_PER_WEEK pour LAN Manager 2.0. Cet élément est ignoré par les fonctions NetUserAdd et NetUserSetInfo .

Pour les applications de service, les unités doivent être l’une des valeurs suivantes : SAM_DAYS_PER_WEEK, SAM_HOURS_PER_WEEK ou SAM_MINUTES_PER_WEEK.

usri11_logon_hours

Type : PBYTE

Pointeur vers une chaîne de bits de 21 octets (168 bits) qui spécifie les heures pendant lesquelles l’utilisateur peut se connecter. Chaque bit représente une heure unique dans la semaine, en heure moyenne de Greenwich (GMT).

Le premier bit (bit 0, mot 0) est dimanche, de 0 :00 à 0 :59 ; le deuxième bit (bit 1, mot 0) est dimanche, de 1 :00 à 1 :59 ; et ainsi de suite. Notez que bit 0 dans le mot 0 représente le dimanche de 0 :00 à 0 :59 uniquement si vous êtes dans le fuseau horaire GMT. Dans tous les autres cas, vous devez ajuster les bits en fonction du décalage de votre fuseau horaire (par exemple, GMT moins 8 heures pour l’heure standard du Pacifique).

Spécifiez un pointeur NULL dans ce membre lors de l’appel de la fonction NetUserAdd pour indiquer aucune restriction de temps. Spécifiez un pointeur NULL lors de l’appel de la fonction NetUserSetInfo pour indiquer qu’aucune modification ne doit être apportée aux heures pendant lesquelles l’utilisateur peut se connecter.

usri11_code_page

Type : DWORD

Page de codes de la langue de choix de l’utilisateur.

Remarques

Les noms de compte d’utilisateur sont limités à 20 caractères et les noms de groupe à 256 caractères. En outre, les noms de comptes ne peuvent pas être arrêtés par un point et ils ne peuvent pas inclure de virgules ou d’un des caractères imprimables suivants : « , /, , , [, ], :, |, <, , >+, =, ?, *. Les noms ne peuvent pas non plus inclure de caractères dans la plage 1 à 31, qui ne sont pas imprimables.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	lmaccess.h (include Lm.h)