Поделиться через


Метод IGroupPolicyObject::New (gpedit.h)

Метод New создает новый объект групповой политики в Active Directory с указанным отображаемым именем. Метод открывает объект групповой политики с помощью метода OpenDSGPO .

Синтаксис

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

Параметры

[in] pszDomainName

Указывает путь Active Directory к создаваемому объекту. Если путь указывает контроллер домена, объект групповой политики создается на этом контроллере домена. В противном случае система выберет контроллер домена от имени вызывающей стороны.

[in] pszDisplayName

Указывает отображаемое имя создаваемого объекта.

[in] dwFlags

Указывает, следует ли загружать сведения реестра для объекта групповой политики. Этот параметр может принимать одно из указанных ниже значений.

GPO_OPEN_LOAD_REGISTRY

Загрузите сведения о реестре.

GPO_OPEN_READ_ONLY

Откройте объект групповой политики в режиме только для чтения.

Возвращаемое значение

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в файле заголовка пакета SDK для платформы WinError.h.

Комментарии

Чтобы открыть объект групповой политики, который уже существует, можно вызвать метод OpenDSGPO .

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header gpedit.h
DLL Gpedit.dll

См. также раздел

Интерфейсы групповая политика

Обзор групповых политик

IGroupPolicyObject

OpenDSGPO