Метод IDsAdminNewObjExt::Initialize (dsadmin.h)

Статья
08/23/2023

Метод IDsAdminNewObjExt::Initialize инициализирует расширение мастера создания объектов.

Синтаксис

HRESULT Initialize(
  [in] IADsContainer         *pADsContainerObj,
  [in] IADs                  *pADsCopySource,
  [in] LPCWSTR               lpszClassName,
  [in] IDsAdminNewObj        *pDsAdminNewObj,
  [in] LPDSA_NEWOBJ_DISPINFO pDispInfo
);

Параметры

[in] pADsContainerObj

Указатель на интерфейс IADsContainer существующего контейнера, в котором создается объект . Этот параметр не должен иметь значение NULL. Если этот объект следует сохранить за пределами область этого метода, количество ссылок необходимо увеличить путем вызова IUnknown::AddRef или IUnknown::QueryInterface.

[in] pADsCopySource

Указатель на интерфейс IAD объекта, из которого создается копия. Если новый объект не копируется из другого объекта, этот параметр имеет значение NULL. Дополнительные сведения об операциях копирования см. в разделе Примечания. Если этот объект следует сохранить за пределами область этого метода, количество ссылок необходимо увеличить путем вызова IUnknown::AddRef или IUnknown::QueryInterface.

[in] lpszClassName

Указатель на строку WCHAR , содержащую ldap-имя создаваемого класса объекта. Этот параметр не должен иметь значение NULL. Поддерживаемые значения: user, computer, printQueue, group и contact.

[in] pDsAdminNewObj

Указатель на интерфейс IDsAdminNewObj , содержащий дополнительные данные о мастере. Вы также можете получить интерфейс IDsAdminNewObjPrimarySite основного расширения, вызвав QueryInterface с IID_IDsAdminNewObjPrimarySite в этом интерфейсе. Если этот объект следует сохранить за пределами область этого метода, количество ссылок необходимо увеличить путем вызова IUnknown::AddRef или IUnknown::QueryInterface.

[in] pDispInfo

Указатель на структуру DSA_NEWOBJ_DISPINFO , содержащую дополнительные данные о мастере создания объектов.

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

Возвращает S_OK в случае успешного выполнения или код ошибки, определенный OLE.

Объект в доменные службы Active Directory можно создать из ничего или скопировать из существующего объекта. Если новый объект создается из существующего объекта, pADsCopySource будет содержать указатель на объект, из которого создается копия. Если новый объект не копируется из другого объекта, pADsCopySource будет иметь значение NULL. Операция копирования поддерживается только для объектов пользователя.

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	dsadmin.h
DLL	DSAdmin.dll