USER_INFO_11 struttura (lmaccess.h)

Articolo
02/28/2024

La struttura USER_INFO_11 contiene informazioni su un account utente, tra cui il nome dell'account, il livello di privilegi, il percorso della home directory dell'utente e altre statistiche di rete correlate all'utente.

Sintassi

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;

Members

usri11_name

Tipo: LPWSTR

Puntatore a un carattere Unicode che specifica il nome dell'account utente. Le chiamate alla funzione NetUserSetInfo ignorano questo membro. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

usri11_comment

Tipo: LPWSTR

Puntatore a una stringa Unicode contenente un commento associato all'account utente. Questa stringa può essere una stringa NULL oppure può avere un numero qualsiasi di caratteri prima del carattere Null terminante.

usri11_usr_comment

Tipo: LPWSTR

Puntatore a una stringa Unicode contenente un commento utente. Questa stringa può essere una stringa NULL oppure può avere un numero qualsiasi di caratteri prima del carattere Null terminante.

usri11_full_name

Tipo: LPWSTR

Puntatore a una stringa Unicode contenente il nome completo dell'utente. Questa stringa può essere una stringa NULL oppure può avere un numero qualsiasi di caratteri prima del carattere Null terminante.

usri11_priv

Tipo: DWORD

Livello di privilegio assegnato al membro usri11_name . Per le chiamate alla funzione NetUserAdd , questo membro deve essere USER_PRIV_USER. Per le chiamate a NetUserSetInfo, questo membro deve essere il valore restituito dalla funzione NetUserGetInfo o dalla funzione NetUserEnum . Questo membro può essere uno dei valori seguenti. Per altre informazioni sui diritti dell'account utente e del gruppo, vedere Privilegi.

Valore	Significato
USER_PRIV_GUEST	Guest
USER_PRIV_USER	Utente
USER_PRIV_ADMIN	Amministratore

usri11_auth_flags

Tipo: DWORD

Set di flag di bit che definiscono i privilegi dell'operatore dell'utente.

Le chiamate alla funzione NetUserGetInfo e la funzione NetUserEnum restituiscono un valore in base all'appartenenza al gruppo locale dell'utente. Se l'utente è membro di Print Operator, AF_OP_PRINT è impostato. Se l'utente è membro di Operatori server, AF_OP_SERVER è impostato. Se l'utente è membro degli operatori account, AF_OP_ACCOUNTS è impostato. AF_OP_COMM non è mai impostato.

Le funzioni NetUserAdd e NetUserSetInfo ignorano questo membro.

Si applicano le restrizioni seguenti:

Quando si chiama la funzione NetUserAdd , questo membro deve essere zero.
Quando si chiama la funzione NetUserSetInfo , questo membro deve essere il valore restituito da una chiamata a NetUserGetInfo o a NetUserEnum.

Questo membro può essere uno o più dei valori seguenti.

Valore	Significato
AF_OP_PRINT	Il privilegio dell'operatore di stampa è abilitato.
AF_OP_COMM	Il privilegio dell'operatore di comunicazione è abilitato.
AF_OP_SERVER	Il privilegio dell'operatore server è abilitato.
AF_OP_ACCOUNTS	Il privilegio dell'operatore account è abilitato.

usri11_password_age

Tipo: DWORD

Numero di secondi trascorsi dall'ultima modifica del membro usri11_password . Le funzioni NetUserAdd e NetUserSetInfo ignorano questo membro.

usri11_home_dir

Tipo: LPWSTR

Puntatore a una stringa Unicode che specifica il percorso della home directory per l'utente specificato nel membro usri11_name . La stringa può essere NULL.

usri11_parms

Tipo: LPWSTR

Puntatore a una stringa Unicode riservata per l'uso da parte delle applicazioni. Questa stringa può essere una stringa NULL oppure può avere un numero qualsiasi di caratteri prima del carattere Null terminante. I prodotti Microsoft usano questo membro per archiviare le informazioni di configurazione utente. Non modificare queste informazioni.

usri11_last_logon

Tipo: DWORD

Data e ora in cui si è verificato l'ultimo accesso. Questo valore viene archiviato come numero di secondi trascorsi dalle 00:00:00, 1 gennaio 1970, GMT. Le funzioni NetUserAdd e NetUserSetInfo ignorano questo membro.

Questo membro viene mantenuto separatamente in ogni controller di dominio di backup (BDC) nel dominio. Per ottenere un valore accurato, è necessario eseguire query su ogni BDC nel dominio. L'ultimo accesso si è verificato al momento indicato dal valore recuperato più grande.

usri11_last_logoff

Tipo: DWORD

Questo membro non viene attualmente usato.

Data e ora in cui si è verificato l'ultimo logoff. Questo valore viene archiviato come numero di secondi trascorsi dalle 00:00:00, 1 gennaio 1970, GMT. Un valore pari a zero indica che l'ultima ora di disconnessione è sconosciuta. La funzione NetUserAdd e la funzione NetUserSetInfo ignorano questo membro.

Questo membro viene mantenuto separatamente in ogni controller di dominio di backup (BDC) nel dominio. Per ottenere un valore accurato, è necessario eseguire query su ogni BDC nel dominio. L'ultimo logoff si è verificato al momento indicato dal valore recuperato più grande.

usri11_bad_pw_count

Tipo: DWORD

Numero di volte in cui l'utente ha tentato di accedere a questo account usando una password errata. Un valore di – 1 indica che il valore è sconosciuto. Le funzioni NetUserAdd e NetUserSetInfo ignorano questo membro.

Questo membro viene replicato dal controller di dominio primario (PDC); viene gestito anche in ogni controller di dominio di backup (BDC) nel dominio. Per ottenere un valore accurato, è necessario eseguire query su ogni BDC nel dominio. Il numero di volte in cui l'utente ha tentato di accedere usando una password errata è il valore più grande recuperato.

usri11_num_logons

Tipo: DWORD

Numero di volte in cui l'utente ha eseguito l'accesso correttamente a questo account. Un valore di – 1 indica che il valore è sconosciuto. Le chiamate alle funzioni NetUserAdd e NetUserSetInfo ignorano questo membro.

Questo membro viene mantenuto separatamente in ogni controller di dominio di backup (BDC) nel dominio. Per ottenere un valore accurato, è necessario eseguire query su ogni BDC nel dominio. Il numero di volte in cui l'utente ha eseguito l'accesso è la somma dei valori recuperati.

usri11_logon_server

Tipo: LPWSTR

Puntatore a una stringa Unicode contenente il nome del server a cui vengono inviate richieste di accesso. I nomi dei server devono essere preceduti da due barre rovesciate (\). Per indicare che la richiesta di accesso può essere gestita da qualsiasi server di accesso, specificare un asterisco (\*) per il nome del server. Una stringa NULL indica che le richieste devono essere inviate al controller di dominio.

Per i server Windows, NetUserGetInfo e NetUserEnum restituiscono \*. Le funzioni NetUserAdd e NetUserSetInfo ignorano questo membro.

usri11_country_code

Tipo: DWORD

Codice paese/area geografica per la lingua scelta dall'utente.

usri11_workstations

Tipo: LPWSTR

Puntatore a una stringa Unicode contenente i nomi delle workstation da cui l'utente può accedere. È possibile specificare fino a otto workstation; i nomi devono essere separati da virgole. Una stringa NULL indica che non esiste alcuna restrizione. Per disabilitare gli accessi da tutte le workstation a questo account, impostare il valore UF_ACCOUNTDISABLE nel membro usri11_flags .

usri11_max_storage

Tipo: DWORD

Quantità massima di spazio su disco che l'utente può usare. Specificare USER_MAXSTORAGE_UNLIMITED per usare tutto lo spazio disponibile su disco.

usri11_units_per_week

Tipo: DWORD

Numero di unità di tempo di uguale lunghezza in cui viene divisa la settimana. Questo valore è necessario per calcolare la lunghezza della stringa di bit nel membro usri11_logon_hours .

Questo membro deve essere UNITS_PER_WEEK per LAN Manager 2.0. Questo elemento viene ignorato dalle funzioni NetUserAdd e NetUserSetInfo .

Per le applicazioni di servizio, le unità devono essere uno dei valori seguenti: SAM_DAYS_PER_WEEK, SAM_HOURS_PER_WEEK o SAM_MINUTES_PER_WEEK.

usri11_logon_hours

Tipo: PBYTE

Puntatore a una stringa di bit a 21 byte (168 bit) che specifica i tempi durante i quali l'utente può accedere. Ogni bit rappresenta un'ora univoca nella settimana, in Greenwich Mean Time (GMT).

Il primo bit (bit 0, parola 0) è domenica, da 0:00 a 0:59; il secondo bit (bit 1, parola 0) è domenica, dalle 1:00 alle 1:59; E così via. Si noti che il bit 0 in word 0 rappresenta domenica dalle 0:00 alle 0:59 solo se si è nel fuso orario GMT. In tutti gli altri casi è necessario regolare i bit in base alla differenza di fuso orario (ad esempio, GMT meno 8 ore per l'ora solare del Pacifico).

Specificare un puntatore NULL in questo membro quando si chiama la funzione NetUserAdd per indicare nessuna restrizione temporale. Specificare un puntatore NULL quando si chiama la funzione NetUserSetInfo per indicare che non deve essere apportata alcuna modifica agli orari durante i quali l'utente può accedere.

usri11_code_page

Tipo: DWORD

Tabella codici per la lingua scelta dall'utente.

Commenti

I nomi degli account utente sono limitati a 20 caratteri e i nomi dei gruppi sono limitati a 256 caratteri. Inoltre, i nomi di account non possono essere terminati da un punto e non possono includere virgole o uno dei caratteri stampabili seguenti: ", /, , [, ], :, |, <, , >+, =, ;, ?, *. I nomi non possono includere anche caratteri nell'intervallo 1-31, che non sono stampabili.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	lmaccess.h (include Lm.h)