Metodo IWbemClassObject::Clone (wbemcli.h)

Il metodo IWbemClassObject::Clone restituisce un nuovo oggetto che è un clone completo dell'oggetto corrente. Il nuovo oggetto ha un numero di riferimenti COM pari a 1.

Sintassi

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

Parametri

[out] ppCopy

Questo parametro non può essere NULL. Riceve la copia dell'oggetto corrente. È necessario chiamare IWbemClassObject::Release in questo oggetto quando non è più necessario.

Un nuovo oggetto non viene restituito in caso di errore.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in un HRESULT. Per i valori HRESULT generali, vedere Codici di errore di sistema.

Commenti

Usare questo metodo per duplicare una definizione di classe o duplicare un'istanza. Ciò può essere utile quando la copia originale dell'oggetto è necessaria per scopi di backup mentre viene modificata una nuova copia. Analogamente, usare questo metodo per creare molte nuove istanze da un'istanza di origine singola. Ad esempio, usare IWbemClassObject::SpawnInstance per creare una singola istanza iniziale e usare IWbemClassObject ::Clone per produrre rapidamente 100 copie dell'istanza. Ogni oggetto può essere modificato successivamente per assumere i relativi valori specifici.

Non è possibile usare questo metodo per convertire una definizione di classe in un'istanza o convertire un'istanza in una definizione di classe.

Requisiti