Funzione NetGroupGetInfo (lmaccess.h)

Articolo
03/05/2024

La funzione NetGroupGetInfo recupera informazioni su un determinato 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 NetGroupGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR groupname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

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 recuperare 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
0	Restituisce il nome del gruppo globale. Il parametro bufptr punta a una struttura GROUP_INFO_0 .
1	Restituisce il nome del gruppo globale e un commento. Il parametro bufptr punta a una struttura GROUP_INFO_1 .
2	Restituisce informazioni dettagliate sul gruppo globale. Il parametro bufptr punta a una struttura GROUP_INFO_2 . Si noti che in Windows XP e versioni successive è consigliabile usare GROUP_INFO_3 .
3	Restituisce informazioni dettagliate sul gruppo globale. Il parametro bufptr punta a una struttura GROUP_INFO_3 . Windows 2000: Questo livello non è supportato.

[out] bufptr

Puntatore all'indirizzo del buffer che riceve la struttura delle informazioni del gruppo globale. Il formato di questi dati dipende dal valore del parametro di livello . Il sistema alloca la memoria per questo buffer. È necessario chiamare la funzione NetApiBufferFree per deallocare la memoria. Per altre informazioni, vedere Buffer delle funzioni di gestione della rete e lunghezze del buffer delle funzioni di gestione della rete.

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
ERROR_ACCESS_DENIED	L'utente non ha accesso alle informazioni richieste.
NERR_InvalidComputer	Il nome del computer non è valido.
NERR_GroupNotFound	Impossibile trovare il nome del gruppo globale.

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 a tutti gli utenti autenticati e ai membri del gruppo "Accesso compatibile con Windows 2000" di pre-Windows 2000 per visualizzare le informazioni. Se si chiama questa funzione in un server membro o in una workstation, tutti gli utenti autenticati possono visualizzare le informazioni. Per informazioni sull'accesso anonimo e sulla limitazione dell'accesso anonimo in queste piattaforme, 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.

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