Clone-Funktion
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