Método IWbemClassObject::Clone (wbemcli.h)

El método IWbemClassObject::Clone devuelve un nuevo objeto que es un clon completo del objeto actual. El nuevo objeto tiene un recuento de referencias COM de 1.

Sintaxis

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

Parámetros

[out] ppCopy

Este parámetro no puede ser NULL. Recibe la copia del objeto actual. Debe llamar a IWbemClassObject::Release en este objeto cuando ya no sea necesario.

No se devuelve un nuevo objeto cuando se produce un error.

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

Comentarios

Use este método para duplicar una definición de clase o para duplicar una instancia. Esto puede ser útil cuando se requiere la copia original del objeto con fines de copia de seguridad mientras se modifica una nueva copia. Del mismo modo, use este método para crear muchas instancias nuevas a partir de una única instancia de origen. Por ejemplo, use IWbemClassObject::SpawnInstance para crear una única instancia de inicio y use IWbemClassObject::Clone para generar 100 copias de la instancia rápidamente. Cada objeto se puede modificar posteriormente para asumir sus valores concretos.

No es posible usar este método para convertir una definición de clase en una instancia o convertir una instancia en una definición de clase.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)
Library	WbemUuid.lib
Archivo DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll