Condividi tramite


struttura GROUP_POLICY_OBJECTW (userenv.h)

La struttura GROUP_POLICY_OBJECT fornisce informazioni su un oggetto Criteri di gruppo in un elenco oggetti Criteri di gruppo.

Sintassi

typedef struct _GROUP_POLICY_OBJECTW {
  DWORD                        dwOptions;
  DWORD                        dwVersion;
  LPWSTR                       lpDSPath;
  LPWSTR                       lpFileSysPath;
  LPWSTR                       lpDisplayName;
  WCHAR                        szGPOName[50];
  GPO_LINK                     GPOLink;
  LPARAM                       lParam;
  struct _GROUP_POLICY_OBJECTW *pNext;
  struct _GROUP_POLICY_OBJECTW *pPrev;
  LPWSTR                       lpExtensions;
  LPARAM                       lParam2;
  LPWSTR                       lpLink;
} GROUP_POLICY_OBJECTW, *PGROUP_POLICY_OBJECTW;

Membri

dwOptions

Specifica le opzioni di collegamento. Questo membro può essere uno dei valori seguenti.

GPO_FLAG_DISABLE

Questo oggetto Criteri di gruppo è disabilitato.

GPO_FLAG_FORCE

Non eseguire l'override delle impostazioni dei criteri in questo oggetto Criteri di gruppo con le impostazioni dei criteri in un oggetto Criteri di gruppo successivo.

dwVersion

Specifica il numero di versione dell'oggetto Criteri di gruppo.

lpDSPath

Puntatore a una stringa che specifica il percorso della parte del servizio directory dell'oggetto Criteri di gruppo.

lpFileSysPath

Puntatore a una stringa che specifica il percorso della parte del file system dell'oggetto Criteri di gruppo.

lpDisplayName

Puntatore al nome visualizzato dell'oggetto Criteri di gruppo.

szGPOName[50]

Puntatore a una stringa che specifica un nome univoco che identifica l'oggetto Criteri di gruppo.

GPOLink

Specifica le informazioni sul collegamento per l'oggetto Criteri di gruppo. Questo membro può essere uno dei valori seguenti.

GPLinkUnknown

Non sono disponibili informazioni sul collegamento.

GPLinkMachine

L'oggetto Criteri di gruppo è collegato a un computer (locale o remoto).

GPLinkSite

L'oggetto Criteri di gruppo è collegato a un sito.

GPLinkDomain

L'oggetto Criteri di gruppo è collegato a un dominio.

GPLinkOrganizationalUnit

L'oggetto Criteri di gruppo è collegato a un'unità organizzativa.

lParam

Dati forniti dall'utente.

pNext

Puntatore all'oggetto Criteri di gruppo successivo nell'elenco.

pPrev

Puntatore all'oggetto Criteri di gruppo precedente nell'elenco.

lpExtensions

Estensioni che hanno archiviato i dati in questo oggetto Criteri di gruppo. Il formato è una stringa di GUIDs raggruppati tra parentesi quadre. Per altre informazioni, vedere la sezione Osservazioni seguente.

lParam2

Dati forniti dall'utente.

lpLink

Percorso dell'unità organizzativa, dominio o sito di Active Directory a cui è collegato questo oggetto Criteri di gruppo. Se l'oggetto Criteri di gruppo è collegato all'oggetto Criteri di gruppo locale, questo membro è "Local".

Osservazioni

Ogni oggetto Criteri di gruppo può contenere dati che devono essere elaborati da più estensioni snap-in. Di conseguenza, i dati nel membro lpExtensions sono organizzati come una serie di GUIDche identificano le estensioni e le estensioni snap-in. Il formato dei dati è il seguente:

[ext_guid1, snap_in_guid1, snap_in_guid2, ...] 
[ext_guid2, snap_in_guid3, snap_in_guid4, ...] 

In primo luogo, è presente una parentesi aperta , "[", seguita dal GUID dell'estensione. Successivamente, è possibile trovare uno o più GUID identificare le estensioni snap-in che hanno archiviato i dati nell'oggetto Criteri di gruppo. Dopo l'ultimo snap-in GUID per un'estensione, è presente una parentesi chiusa "]". Questo modello viene ripetuto per l'estensione successiva.

Nota

L'intestazione userenv.h definisce GROUP_POLICY_OBJECT 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
intestazione userenv.h

Vedere anche

FreeGPOList

GetGPOList

Panoramica di Criteri di gruppo

strutture di Criteri di gruppo