Метод IWbemClassObject::Clone (wbemcli.h)

Метод IWbemClassObject::Clone возвращает новый объект, который является полным клоном текущего объекта. Новый объект имеет число ссылок COM 1.

Синтаксис

HRESULT Clone(
  [out] IWbemClassObject **ppCopy
);

Параметры

[out] ppCopy

Этот параметр не может иметь значение NULL. Он получает копию текущего объекта . Для этого объекта необходимо вызывать IWbemClassObject::Release , если он больше не требуется.

При ошибке новый объект не возвращается.

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

Этот метод возвращает HRESULT , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в HRESULT. Общие значения HRESULT см. в разделе Системные коды ошибок.

Комментарии

Используйте этот метод для дублирования определения класса или для дублирования экземпляра. Это может быть полезно, если исходная копия объекта требуется для резервного копирования во время изменения новой копии. Аналогичным образом используйте этот метод для создания множества новых экземпляров из одного исходного экземпляра. Например, используйте IWbemClassObject::SpawnInstance для создания одного начального экземпляра, а IWbemClassObject::Clone — для быстрого создания 100 копий экземпляра. Каждый объект может быть впоследствии изменен для получения определенных значений.

Этот метод нельзя использовать для преобразования определения класса в экземпляр или преобразования экземпляра в определение класса.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll