Funzione NetLocalGroupSetInfo (lmaccess.h)
La funzione NetLocalGroupSetInfo modifica il nome di un gruppo locale esistente. La funzione associa anche un commento a un gruppo locale.
Sintassi
NET_API_STATUS NET_API_FUNCTION NetLocalGroupSetInfo(
[in] LPCWSTR servername,
[in] LPCWSTR groupname,
[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 deve essere eseguita la funzione. Se questo parametro è NULL, viene utilizzato il computer locale.
[in] groupname
Puntatore a una stringa costante che specifica il nome dell'account del gruppo locale da modificare. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
[in] level
Specifica il livello di informazioni dei dati. Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Specifica il nome del gruppo locale. Il parametro buf punta a una struttura LOCALGROUP_INFO_0 . Usare questo livello per modificare il nome di un gruppo locale esistente. |
|
Specifica il nome del gruppo locale e un commento da associare al gruppo. Il parametro buf punta a una struttura LOCALGROUP_INFO_1 . |
|
Specifica un commento da associare al gruppo locale. Il parametro buf punta a una struttura LOCALGROUP_INFO_1002 . |
[in] buf
Puntatore a un buffer contenente le informazioni sul gruppo locale. Il formato di questi dati dipende dal valore del parametro level . Per altre informazioni, vedere Buffer delle funzioni di gestione di rete.
[out] parm_err
Puntatore a un valore che riceve l'indice del primo membro della struttura delle informazioni del gruppo locale che ha causato l'errore di 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 viene NERR_Success.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'utente non ha accesso alle informazioni richieste. |
|
Uno dei parametri della funzione non è valido. Per ulteriori informazioni, vedere la sezione Osservazioni successiva. |
|
Il gruppo locale specificato non esiste. |
|
L'operazione è consentita solo nel controller di dominio primario del dominio. |
|
Il nome del computer non è valido. |
Commenti
Se si chiama questa funzione in un controller di dominio che esegue Active Directory, l'accesso viene 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 gli amministratori e Power Users possono chiamare questa funzione. Per altre informazioni, vedere Requisiti di sicurezza per le funzioni di gestione di rete. Per altre informazioni su ACL, ACL e token di accesso, vedere Controllo di accesso Model.
Il descrittore di sicurezza dell'oggetto LocalGroup viene utilizzato per eseguire il controllo di accesso per questa funzione. In genere, i chiamanti devono avere accesso in scrittura all'intero oggetto per consentire l'esito positivo delle chiamate a questa funzione.
Per specificare il nuovo nome di un gruppo locale esistente, chiamare NetLocalGroupSetInfo con LOCALGROUP_INFO_0 e specificare un valore usando il membro lgrpi0_name . Se si chiama la funzione NetLocalGroupSetInfo con LOCALGROUP_INFO_1 e si specifica un nuovo valore usando il membro lgrpi1_name , tale valore verrà ignorato.
Se la funzione NetLocalGroupSetInfo restituisce ERROR_INVALID_PARAMETER, è possibile utilizzare il parametro parm_err per indicare il primo membro della struttura delle informazioni del gruppo locale non valida. Una struttura di informazioni sul gruppo locale inizia con LOCALGROUP_INFO_ e il relativo formato viene specificato dal parametro level . Nella tabella seguente sono elencati i valori che è possibile restituire nel parametro parm_err e nel membro della struttura corrispondente in errore. Il prefisso lgrpi*_ indica che il membro può iniziare con più prefissi, ad esempio lgrpi0_ o lgrpi1_.
| Valore | Membro |
|---|---|
| LOCALGROUP_NAME_PARMNUM | lgrpi*_name |
| LOCALGROUP_COMMENT_PARMNUM | lgrpi*_comment |
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.
Se si esegue la programmazione per Active Directory, è possibile chiamare determinati metodi ADSI (Active Directory Service Interface) per ottenere la stessa funzionalità che è possibile ottenere chiamando le funzioni del gruppo locale di gestione di rete. Per altre informazioni, vedere IADsGroup.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | lmaccess.h (include Lm.h) |
| Libreria | Netapi32.lib |
| DLL | Netapi32.dll |