struttura USER_INFO_2 (lmaccess.h)
La struttura USER_INFO_2 contiene informazioni su un account utente, inclusi il nome dell'account, i dati della password, il livello di privilegio, il percorso della home directory dell'utente e altre statistiche di rete correlate all'utente.
Sintassi
typedef struct _USER_INFO_2 {
LPWSTR usri2_name;
LPWSTR usri2_password;
DWORD usri2_password_age;
DWORD usri2_priv;
LPWSTR usri2_home_dir;
LPWSTR usri2_comment;
DWORD usri2_flags;
LPWSTR usri2_script_path;
DWORD usri2_auth_flags;
LPWSTR usri2_full_name;
LPWSTR usri2_usr_comment;
LPWSTR usri2_parms;
LPWSTR usri2_workstations;
DWORD usri2_last_logon;
DWORD usri2_last_logoff;
DWORD usri2_acct_expires;
DWORD usri2_max_storage;
DWORD usri2_units_per_week;
PBYTE usri2_logon_hours;
DWORD usri2_bad_pw_count;
DWORD usri2_num_logons;
LPWSTR usri2_logon_server;
DWORD usri2_country_code;
DWORD usri2_code_page;
} USER_INFO_2, *PUSER_INFO_2, *LPUSER_INFO_2;
Members
usri2_name
Tipo: LPWSTR
Puntatore a una stringa Unicode che specifica il nome dell'account utente. Le chiamate alla funzione NetUserSetInfo ignorano questo membro. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
usri2_password
Tipo: LPWSTR
Puntatore a una stringa Unicode che specifica la password per l'utente identificato dal membro usri2_name . La lunghezza non può superare i byte di PWLEN. Le funzioni NetUserEnum e NetUserGetInfo restituiscono un puntatore NULL per mantenere la sicurezza delle password.
Per convenzione, la lunghezza delle password è limitata a LM20_PWLEN caratteri.
usri2_password_age
Tipo: DWORD
Numero di secondi trascorsi dall'ultima modifica del membro usri2_password . Le funzioni NetUserAdd e NetUserSetInfo ignorano questo membro.
usri2_priv
Tipo: DWORD
Livello di privilegio assegnato al membro usri2_name . Per le chiamate alla funzione NetUserAdd , questo membro deve essere USER_PRIV_USER. Per la funzione 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 |
|---|---|
|
Guest |
|
Utente |
|
Amministratore |
usri2_home_dir
Tipo: LPWSTR
Puntatore a una stringa Unicode che specifica il percorso della home directory per l'utente specificato dal membro usri2_name . La stringa può essere NULL.
usri2_comment
Tipo: LPWSTR
Puntatore a una stringa Unicode contenente un commento da associare all'account utente. La stringa può essere una stringa NULL oppure può avere un numero qualsiasi di caratteri prima del carattere Null di terminazione.
usri2_flags
Tipo: DWORD
Questo membro può essere uno o più dei valori seguenti.
Si noti che l'impostazione dei flag di controllo dell'account utente può richiedere determinati privilegi e controllare i diritti di accesso. Per altre informazioni, vedere la sezione Osservazioni della funzione NetUserSetInfo .
| Valore | Significato |
|---|---|
|
Script di accesso eseguito. Questo valore deve essere impostato. |
|
L'account dell'utente è disabilitato. |
|
La home directory è obbligatoria. Questo valore viene ignorato. |
|
Non è necessaria alcuna password. |
|
L'utente non può modificare la password. |
|
L'account è attualmente bloccato. È possibile chiamare la funzione NetUserSetInfo per cancellare questo valore e sbloccare un account bloccato in precedenza. Non è possibile usare questo valore per bloccare un account sbloccato in precedenza. |
|
La password non deve mai scadere nell'account. |
|
La password dell'utente viene archiviata in crittografia reversibile in Active Directory. |
|
Contrassegna l'account come "sensibile"; altri utenti non possono fungere da delegati di questo account utente. |
|
Richiede all'utente di accedere all'account utente con una smart card. |
|
Limitare questa entità all'uso solo dei tipi di crittografia DES (Data Encryption Standard) per le chiavi. |
|
Questo account non richiede la preautenticazione Kerberos per l'accesso. |
|
L'account è abilitato per la delega. Si tratta di un'impostazione sensibile alla sicurezza; gli account con questa opzione abilitata devono essere strettamente controllati. Questa impostazione consente a un servizio in esecuzione nell'account di presupporre l'identità di un client ed eseguire l'autenticazione come tale utente in altri server remoti nella rete. |
|
La password dell'utente è scaduta.
Windows 2000: Questo valore non è supportato. |
|
L'account è attendibile per autenticare un utente all'esterno del pacchetto di sicurezza Kerberos e delegare l'utente tramite la delega vincolata. Si tratta di un'impostazione sensibile alla sicurezza; gli account con questa opzione abilitata devono essere strettamente controllati. Questa impostazione consente a un servizio in esecuzione nell'account di asserire l'identità di un client ed eseguire l'autenticazione come tale utente per servizi configurati in modo specifico nella rete.
Windows XP/2000: Questo valore non è supportato. |
I valori seguenti descrivono il tipo di account. È possibile impostare un solo valore. Non è possibile modificare il tipo di account usando la funzione NetUserSetInfo .
usri2_script_path
Tipo: LPWSTR
Puntatore a una stringa Unicode che specifica il percorso del file di script di accesso dell'utente. Il file di script può essere . File CMD, un file di .EXE o un file di .BAT. La stringa può anche essere NULL.
usri2_auth_flags
Tipo: DWORD
Privilegi dell'operatore dell'utente.
Le chiamate alle funzioni NetUserGetInfo e NetUserEnum restituiscono un valore basato sull'appartenenza al gruppo locale dell'utente. Se l'utente è membro di Operatori di stampa, AF_OP_PRINT è impostato. Se l'utente è membro di Server Operators, AF_OP_SERVER è impostato. Se l'utente è membro degli operatori account, AF_OP_ACCOUNTS è impostato. AF_OP_COMM non è mai impostato. Per altre informazioni sui diritti dell'account utente e del gruppo, vedere Privilegi.
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.
usri2_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 di terminazione.
usri2_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 di terminazione.
usri2_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 di terminazione. I prodotti Microsoft usano questo membro per archiviare le informazioni di configurazione utente. Non modificare queste informazioni.
usri2_workstations
Tipo: LPWSTR
Importante
Non è più consigliabile usare usri2_workstations. È invece possibile controllare l'accesso alle workstation configurando le impostazioni assegnazione diritti utente (Consenti accesso locale e Nega accesso in locale oppure Consenti accesso tramite Servizi Desktop remoto e Nega accesso tramite Servizi Desktop remoto).
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 usri2_flags .
usri2_last_logon
Tipo: DWORD
Data e ora dell'ultimo accesso. Questo valore viene archiviato come numero di secondi trascorsi dalle 00:00:00, 1 gennaio 1970, GMT. Questo membro viene ignorato dalle funzioni NetUserAdd e NetUserSetInfo .
Questo membro viene mantenuto separatamente in ogni controller di dominio di backup (BDC) nel dominio. Per ottenere un valore accurato, è necessario eseguire una query su ogni cluster big data nel dominio. L'ultimo accesso si è verificato al momento indicato dal valore recuperato più grande.
usri2_last_logoff
Tipo: DWORD
Questo membro non è attualmente utilizzato.
Indica quando si è verificata l'ultima disconnessione. Questo valore viene archiviato come numero di secondi trascorsi dalle 00:00:00, 1 gennaio 1970, GMT. Il valore zero indica che l'ora dell'ultima disconnessione è sconosciuta.
Questo membro viene mantenuto separatamente in ogni controller di dominio di backup (BDC) nel dominio. Per ottenere un valore accurato, è necessario eseguire una query su ogni cluster big data nel dominio. L'ultima disconnessione si è verificata al momento indicato dal valore recuperato più grande.
usri2_acct_expires
Tipo: DWORD
Data e ora di scadenza dell'account. Questo valore viene archiviato come numero di secondi trascorsi dalle 00:00:00, 1 gennaio 1970, GMT. Un valore di TIMEQ_FOREVER indica che l'account non scade mai.
usri2_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.
usri2_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 usri2_logon_hours .
Questo valore 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.
usri2_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.
usri2_bad_pw_count
Tipo: DWORD
Numero di tentativi di accesso dell'utente all'account usando una password errata. Il valore - 1 indica che il valore è sconosciuto. Le chiamate alle funzioni NetUserAdd e NetUserSetInfo ignorano questo membro.
Questo membro viene replicato dal controller di dominio primario (PDC); viene mantenuto anche in ogni controller di dominio di backup (BDC) nel dominio. Per ottenere un valore accurato, è necessario eseguire una query su ogni cluster big data nel dominio. Il numero di tentativi di accesso da parte dell'utente con una password errata è il valore più grande recuperato.
usri2_num_logons
Tipo: DWORD
Numero di volte in cui l'utente ha eseguito correttamente l'accesso a questo account. Il valore - 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 una query su ogni cluster big data nel dominio. Il numero di volte in cui l'utente ha eseguito l'accesso è la somma dei valori recuperati.
usri2_logon_server
Tipo: LPWSTR
Puntatore a una stringa Unicode contenente il nome del server a cui vengono inviate le 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.
usri2_country_code
Tipo: DWORD
Codice paese/area geografica per la lingua scelta dall'utente.
usri2_code_page
Tipo: DWORD
Tabella codici per la lingua scelta dall'utente.
Commenti
Per altre informazioni sui diritti dell'account utente e del gruppo, vedere Privilegi.
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) |