Funzione NetUserSetInfo (lmaccess.h)

La funzione NetUserSetInfo imposta i parametri di un account utente.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetUserSetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR username,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parametri

[in] servername

Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del server remoto in cui eseguire la funzione. Se questo parametro è NULL, viene usato il computer locale.

[in] username

Puntatore a una stringa costante che specifica il nome dell'account utente per cui impostare le informazioni. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] level

Livello di informazioni dei dati. Questo parametro può avere uno dei valori seguenti.

[in] buf

Puntatore al buffer che specifica i dati. Il formato di questi dati dipende dal valore del parametro di livello . Per altre informazioni, vedere Buffer delle funzioni di gestione della rete.

[out] parm_err

Puntatore a un valore che riceve l'indice del primo membro della struttura delle informazioni utente che causa ERROR_INVALID_PARAMETER. Se questo parametro è NULL, l'indice non viene restituito in caso di errore. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.

Commenti

Se si sta programmando per Active Directory, potrebbe essere possibile chiamare determinati metodi di Active Directory Service Interface (ADSI) per ottenere la stessa funzionalità che è possibile ottenere chiamando le funzioni utente di gestione della rete. Per altre informazioni, vedere IADsUser e IADsComputer.

Se si chiama questa funzione in un controller di dominio che esegue Active Directory, l'accesso è consentito o negato in base all'elenco di controllo di accesso (ACL) per l'oggetto a protezione diretta. L'elenco di controllo di accesso predefinito consente solo agli amministratori di dominio e agli operatori account di chiamare questa funzione. In un server membro o in una workstation, solo amministratori e Power Users possono chiamare questa funzione. Per altre informazioni, vedere Requisiti di sicurezza per le funzioni di gestione della rete. Per altre informazioni sugli elenchi di controllo di accesso, sugli ACL e sui token di accesso, vedere Controllo di accesso Modello.

Il descrittore di sicurezza dell'oggetto User viene usato per eseguire il controllo di accesso per questa funzione.

Solo gli utenti o le applicazioni con privilegi amministrativi possono chiamare la funzione NetUserSetInfo per modificare la password di un utente. Quando un amministratore chiama NetUserSetInfo, l'unica restrizione applicata è che la nuova lunghezza della password deve essere coerente con le modali di sistema. Un utente o un'applicazione che conosce la password corrente di un utente può chiamare la funzione NetUserChangePassword per modificare la password. Per altre informazioni sulla chiamata di funzioni che richiedono privilegi di amministratore, vedere Esecuzione con privilegi speciali.

I membri del gruppo locale Administrators possono impostare qualsiasi elemento dell'account utente modificabile. Tutti gli utenti possono impostare il membro usri2_country_code della strutturaUSER_INFO_2 (e il membro usri1024_country_code della struttura USER_INFO_1024) per i propri account.

Un membro del gruppo locale dell'operatore account non può impostare i dettagli per un account di classe Administrators, concedere un privilegio amministratore account esistente o modificare il privilegio dell'operatore di qualsiasi account. Se si tenta di modificare il livello di privilegio o disabilitare l'ultimo account con privilegi di amministratore nel database di sicurezza, (il database SAM (Security Account Manager) o, nel caso dei controller di dominio, la funzione NetUserSetInfo ha esito negativo e restituisce NERR_LastAdmin.

Per impostare i flag di controllo dell'account utente seguenti, sono necessari i privilegi seguenti e controllare i diritti di accesso .

Per un elenco delle costanti dei privilegi, vedere Costanti di autorizzazione.

Il modo corretto per specificare il nuovo nome per un account consiste nel chiamare NetUserSetInfo con USER_INFO_0 e specificare il nuovo valore usando il usri0_name membro. Se si chiama NetUserSetInfo con altri livelli di informazioni e si specifica un valore usando un membro usriX_name , il valore viene ignorato.

Si noti che le chiamate a NetUserSetInfo possono modificare la home directory solo per gli account utente creati dal server di rete.

Se la funzione NetUserSetInfo restituisce ERROR_INVALID_PARAMETER, è possibile usare il parametro parm_err per indicare il primo membro della struttura delle informazioni utente non valida. Una struttura di informazioni utente inizia con USER_INFO_ e il relativo formato viene specificato dal parametro di livello . Nella tabella seguente sono elencati i valori che possono essere restituiti nel parametro parm_err e nel membro della struttura corrispondente in errore. Il prefisso usri*_ indica che il membro può iniziare con più prefissi, ad esempio usri10_ o usri1003_.

I nomi degli account utente sono limitati a 20 caratteri e i nomi di gruppo sono limitati a 256 caratteri. Inoltre, i nomi degli 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.

La funzione NetUserSetInfo non controlla il modo in cui i parametri password vengono protetti quando vengono inviati tramite la rete a un server remoto per modificare una password utente. Qualsiasi crittografia di questi parametri viene gestita dal meccanismo RPC (Remote Procedure Call) supportato dal reindirizzamento di rete che fornisce il trasporto di rete. La crittografia è controllata anche dai meccanismi di sicurezza supportati dal computer locale e dai meccanismi di sicurezza supportati dal server di rete remoto specificato nel parametro nome server . Per altre informazioni sulla sicurezza quando viene usato il reindirizzamento di rete Microsoft e il server di rete remoto esegue Microsoft Windows, vedere la documentazione del protocollo per MS-RPCE e MS-SAMR.

Esempio

L'esempio di codice seguente illustra come disabilitare un account utente con una chiamata alla funzione NetUserSetInfo . L'esempio di codice inserisce il membro usri1008_flags della strutturaUSER_INFO_1008, specificando il valore UF_ACCOUNTDISABLE. L'esempio chiama quindi NetUserSetInfo, specificando il livello di informazioni 0.

#ifndef UNICODE
#define UNICODE
#endif
#pragma comment(lib, "netapi32.lib")

#include <stdio.h>
#include <windows.h> 
#include <lm.h>

int wmain(int argc, wchar_t *argv[])
{
   DWORD dwLevel = 1008;
   USER_INFO_1008 ui;
   NET_API_STATUS nStatus;

   if (argc != 3)
   {
      fwprintf(stderr, L"Usage: %s \\\\ServerName UserName\n", argv[0]);
      exit(1);
   }
   // Fill in the USER_INFO_1008 structure member.
   // UF_SCRIPT: required.
   //
   ui.usri1008_flags = UF_SCRIPT | UF_ACCOUNTDISABLE;
   //
   // Call the NetUserSetInfo function 
   //  to disable the account, specifying level 1008.
   //
   nStatus = NetUserSetInfo(argv[1],
                            argv[2],
                            dwLevel,
                            (LPBYTE)&ui,
                            NULL);
   //
   // Display the result of the call.
   //
   if (nStatus == NERR_Success)
      fwprintf(stderr, L"User account %s has been disabled\n", argv[2]);
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);

   return 0;
}

Requisiti

Vedi anche

NetUserGetInfo

Funzioni di gestione della rete

Panoramica sulla gestione della rete

USER_INFO_0

USER_INFO_1

USER_INFO_1003

USER_INFO_1005

USER_INFO_1006

USER_INFO_1007

USER_INFO_1008

USER_INFO_1009

USER_INFO_1010

USER_INFO_1011

USER_INFO_1012

USER_INFO_1013

USER_INFO_1014

USER_INFO_1017

USER_INFO_1020

USER_INFO_1024

USER_INFO_1051

USER_INFO_1052

USER_INFO_1053

USER_INFO_2

USER_INFO_21

USER_INFO_22

USER_INFO_4

Funzioni utente