Clone-Funktion

  • Artikel

Gibt ein neues Objekt zurück, das ein vollständiger Klon des aktuellen Objekts ist.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

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

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz.

ppCopy
[out] Ein neues Objekt, das ein vollständiger Klon von ptr ist. Dieses Argument kann nicht null werden, wenn es die Kopie des aktuellen Objekts empfängt.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten im Code definieren:

Konstante Wert Beschreibung
WBEM_E_FAILED 0x80041001 Ein allgemeiner Fehler ist aufgetreten.
WBEM_E_INVALID_PARAMETER 0x80041008 null wurde als Parameter angegeben und ist in dieser Verwendung nicht zulässig.
WBEM_E_OUT_OF_MEMORY 0x80041006 Es ist nicht genügend Arbeitsspeicher verfügbar, um das Objekt zu klonen.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::Clone-Methode.

Das geklonte Objekt ist ein COM-Objekt mit einer Referenzanzahl von 1.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: Seit Version 4.7.2 verfügbar

Siehe auch