Condividi tramite


Metodo IGroupPolicyObject::New (gpedit.h)

Il metodo New crea un nuovo oggetto Criteri di gruppo in Active Directory con il nome visualizzato specificato. Il metodo apre l'oggetto Criteri di gruppo usando il metodo OpenDSGPO .

Sintassi

HRESULT New(
  [in] LPOLESTR pszDomainName,
  [in] LPOLESTR pszDisplayName,
  [in] DWORD    dwFlags
);

Parametri

[in] pszDomainName

Specifica il percorso di Active Directory dell'oggetto da creare. Se il percorso specifica un controller di dominio, l'oggetto Criteri di gruppo viene creato in tale controller di dominio. In caso contrario, il sistema seleziona un controller di dominio per conto del chiamante.

[in] pszDisplayName

Specifica il nome visualizzato dell'oggetto da creare.

[in] dwFlags

Specifica se le informazioni del Registro di sistema devono essere caricate per l'oggetto Criteri di gruppo. Questo parametro può avere uno dei valori seguenti.

GPO_OPEN_LOAD_REGISTRY

Caricare le informazioni del Registro di sistema.

GPO_OPEN_READ_ONLY

Aprire l'oggetto Criteri di gruppo in modalità di sola lettura.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, il metodo restituisce uno dei codici di errore COM definiti nel file di intestazione di Platform SDK WinError.h.

Commenti

Per aprire un oggetto Criteri di gruppo già esistente, è possibile chiamare il metodo OpenDSGPO .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione gpedit.h
DLL Gpedit.dll

Vedi anche

interfacce Criteri di gruppo

Panoramica di Criteri di gruppo

IGroupPolicyObject

OpenDSGPO