Compartir a través de


Función Clone

Devuelve un objeto nuevo que es un clon completo del objeto actual.

Nota

Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.

Sintaxis

HRESULT Clone (
   [in] int                  vFunc,
   [in] IWbemClassObject*    ptr,
   [out] IWbemClassObject**  ppCopy
);

Parámetros

vFunc
[in] Este parámetro no se usa.

ptr
[in] Puntero a una instancia de IWbemClassObject.

ppCopy
[out] Nuevo objeto que es un clon completo de ptr. Este argumento no puede ser null si recibe la copia del objeto actual.

Valor devuelto

Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:

Constante Value Descripción
WBEM_E_FAILED 0x80041001 Si se devuelve este valor, significará que se ha producido un error general.
WBEM_E_INVALID_PARAMETER 0x80041008 Se especificó null como parámetro y no es legal en este uso.
WBEM_E_OUT_OF_MEMORY 0x80041006 No hay disponible memoria suficiente para clonar el objeto.
WBEM_S_NO_ERROR 0 Si se devuelve este valor, significará que la llamada a la función se realizó correctamente.

Comentarios

Esta función ajusta una llamada al método IWbemClassObject::Clone.

El objeto clonado es un objeto COM que tiene un recuento de referencias de 1.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: WMINet_Utils.idl

Versiones de .NET Framework: está disponible desde la versión 4.7.2

Consulte también