Método IGroupPolicyObject::New (gpedit.h)
O método New cria um novo GPO no Active Directory com o nome de exibição especificado. O método abre o GPO usando o método OpenDSGPO .
Sintaxe
HRESULT New(
[in] LPOLESTR pszDomainName,
[in] LPOLESTR pszDisplayName,
[in] DWORD dwFlags
);
Parâmetros
[in] pszDomainName
Especifica o caminho do Active Directory do objeto a ser criado. Se o caminho especificar um controlador de domínio, o GPO será criado nesse DC. Caso contrário, o sistema selecionará um DC em nome do chamador.
[in] pszDisplayName
Especifica o nome de exibição do objeto a ser criado.
[in] dwFlags
Especifica se as informações do Registro devem ou não ser carregadas para o GPO. Esse parâmetro pode usar um dos valores a seguir.
GPO_OPEN_LOAD_REGISTRY
Carregue as informações do Registro.
GPO_OPEN_READ_ONLY
Abra o GPO no modo somente leitura.
Retornar valor
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos no arquivo de cabeçalho do SDK da Plataforma WinError.h.
Comentários
Para abrir um GPO que já existe, você pode chamar o método OpenDSGPO .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | gpedit.h |
| DLL | Gpedit.dll |