Share via


IWbemClassObject::Clone 메서드(wbemcli.h)

IWbemClassObject::Clone 메서드는 현재 개체의 전체 복제본인 새 개체를 반환합니다. 새 개체의 COM 참조 수는 1입니다.

구문

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

매개 변수

[out] ppCopy

이 매개 변수는 NULL일 수 없습니다. 현재 개체의 복사본을 받습니다. 더 이상 필요하지 않은 경우 이 개체에서 IWbemClassObject::Release 를 호출해야 합니다.

오류 발생시 새 개체가 반환되지 않습니다.

반환 값

이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT에 포함된 값이 나열되어 있습니다. 일반적인 HRESULT 값은시스템 오류 코드를 참조하세요.

설명

클래스 정의를 복제하거나 instance 복제하려면 이 메서드를 사용합니다. 새 복사본을 수정하는 동안 백업을 위해 개체의 원래 복사본이 필요한 경우에 유용할 수 있습니다. 마찬가지로 이 메서드를 사용하여 단일 원본 인스턴스에서 많은 인스턴스를 새로 만듭니다. 예를 들어 IWbemClassObject::SpawnInstance를 사용하여 단일 시작 instance 만들고 IWbemClassObject::Clone을 사용하여 instance 100부를 빠르게 생성합니다. 각 개체는 이후에 특정 값을 적용하도록 수정할 수 있습니다.

이 메서드를 사용하여 클래스 정의를 instance 변환하거나 instance 클래스 정의로 변환할 수 없습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 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