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


Функция CreateGPOLink (gpedit.h)

Функция CreateGPOLink создает связь между указанным объектом групповой политики и указанным сайтом, доменом или подразделением.

Синтаксис

GPEDITAPI HRESULT CreateGPOLink(
  [in] LPOLESTR lpGPO,
  [in] LPOLESTR lpContainer,
  [in] BOOL     fHighPriority
);

Параметры

[in] lpGPO

Значение типа , указывающее путь к объекту групповой политики в формате ADSI ("LDAP://cn=пользователь, ou=users, dc=coname, dc=com"). В этом параметре нельзя указать имя сервера.

[in] lpContainer

Значение типа , указывающее путь Active Directory к сайту, домену или подразделению.

[in] fHighPriority

Значение типа , указывающее приоритет связи. Если этот параметр имеет значение TRUE, система создает ссылку в качестве наивысшего приоритета. Если этот параметр имеет значение FALSE, система создает ссылку в качестве самого низкого приоритета.

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

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

Требования

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

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

DeleteAllGPOLinks

DeleteGPOLink

Функции групповая политика

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