Funzione GetAppliedGPOListA (userenv.h)
La funzione GetAppliedGPOList recupera l'elenco di oggetti Criteri di gruppo applicati per l'utente o il computer specificato.
Sintassi
USERENVAPI DWORD GetAppliedGPOListA(
[in] DWORD dwFlags,
[in] LPCSTR pMachineName,
[in] PSID pSidUser,
[in] GUID *pGuidExtension,
[out] PGROUP_POLICY_OBJECTA *ppGPOList
);
Parametri
[in] dwFlags
Valore che specifica il tipo di criterio. Questo parametro può essere il valore seguente.
GPO_LIST_FLAG_MACHINE
Recupera informazioni sui criteri del computer.
Se questo valore non viene specificato, la funzione recupera solo le informazioni sui criteri utente.
[in] pMachineName
Puntatore al nome del computer remoto. Il formato del nome è "\\computer_name". Se questo parametro è NULL, viene usato il nome del computer locale.
[in] pSidUser
Valore che specifica il SID dell'utente. Se pMachineName non è NULL e dwFlags specifica i criteri utente, pSidUser non può essere NULL.
Se pMachineName è null e pSidUser è null, l'utente è attualmente connesso. Se pMachineName è null e pSidUser non è null, l'utente è rappresentato da pSidUser nel computer locale. Per altre informazioni, vedere identificatori di sicurezza.
[in] pGuidExtension
Valore che specifica il GUID dell'estensione.
[out] ppGPOList
Puntatore che riceve l'elenco delle strutture dell'oggetto Criteri di gruppo. Per altre informazioni, vedere GROUP_POLICY_OBJECT.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS. In caso contrario, la funzione restituisce un codice di errore di sistema. Per un elenco completo dei codici di errore, vedere codici di errore di sistema o il file di intestazione WinError.h.
Osservazioni
Per liberare l'elenco di oggetti Criteri di gruppo al termine dell'elaborazione, chiamare la funzione FreeGPOList
Nota
L'intestazione userenv.h definisce GetAppliedGPOList come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| server minimo supportato | Windows Server 2008 |
| piattaforma di destinazione | Finestre |
| intestazione |
userenv.h |
| libreria |
Userenv.lib |
| dll | Userenv.dll |