Funzione NetGroupSetInfo (lmaccess.h)
La funzione NetGroupSetInfo imposta i parametri di un gruppo globale nel database di sicurezza, ovvero il database SAM (Security Account Manager) o, nel caso dei controller di dominio, Active Directory.
Sintassi
NET_API_STATUS NET_API_FUNCTION NetGroupSetInfo(
[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 eseguire la funzione. Se questo parametro è NULL, viene usato il computer locale.
[in] groupname
Puntatore a una stringa costante che specifica il nome del gruppo globale per cui impostare le informazioni. 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 un nome di gruppo globale. Il parametro buf punta a una struttura GROUP_INFO_0 . |
|
Specifica un nome di gruppo globale e un commento. Il parametro buf punta a una struttura GROUP_INFO_1 . |
|
Specifica informazioni dettagliate sul gruppo globale. Il parametro buf punta a una struttura GROUP_INFO_2 . Si noti che in Windows XP e versioni successive è consigliabile usare GROUP_INFO_3 . |
|
Specifica informazioni dettagliate sul gruppo globale. Il parametro buf punta a una struttura GROUP_INFO_3 .
Windows 2000: Questo livello non è supportato. |
|
Specifica un commento solo sul gruppo globale. Il parametro buf punta a una struttura GROUP_INFO_1002 . |
|
Specifica gli attributi del gruppo globale. Il parametro buf punta a una struttura GROUP_INFO_1005 . |
Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
[in] buf
Puntatore a un buffer contenente 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 del gruppo in errore seguendo un codice di errore 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.
| 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 nome del computer non è valido. |
|
L'operazione è consentita solo nel controller di dominio primario del dominio. |
|
Impossibile trovare il nome del gruppo globale. |
|
L'operazione non è consentita in determinati gruppi speciali. Questi gruppi includono gruppi di utenti, gruppi di amministratori, gruppi locali e gruppi guest. |
Commenti
Se si sta programmando per Active Directory, è possibile chiamare determinati metodi di Active Directory Service Interface (ADSI) per ottenere la stessa funzionalità che è possibile ottenere chiamando le funzioni del gruppo di gestione di rete. Per altre informazioni, vedere IADsGroup.
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 Group viene usato per eseguire il controllo di accesso per questa funzione. In genere, i chiamanti devono avere accesso in scrittura all'intero oggetto per le chiamate a questa funzione.
Il modo corretto per impostare il nuovo nome di un gruppo globale consiste nel chiamare la funzione NetGroupSetInfo usando una struttura GROUP_INFO_0 . Specificare il nuovo valore nel membro grpi0_name . Se si usa una struttura GROUP_INFO_1 e si specifica il valore nel membro grpi1_name , il nuovo valore del nome viene ignorato.
Se la funzione NetGroupSetInfo restituisce ERROR_INVALID_PARAMETER, è possibile usare il parametro parm_err per indicare il primo membro della struttura delle informazioni del gruppo non valida. Una struttura di informazioni del gruppo inizia con GROUP_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 grpi*_ indica che il membro può iniziare con più prefissi, ad esempio grpi1_ o grpi2_.
| Valore | Membro |
|---|---|
| GROUP_NAME_PARMNUM | grpi*_name |
| GROUP_COMMENT_PARMNUM | grpi*_comment |
| GROUP_ATTRIBUTES_PARMNUM | grpi*_attributes |
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.
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 |