SpawnInstance-Funktion
Erstellt eine neue Instanz einer Klasse.
Hinweis
Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.
Syntax
HRESULT SpawnInstance (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG lFlags,
[out] IWbemClassObject** ppNewInstance);
Parameter
vFunc
[in] Dieser Parameter wird nicht verwendet.
ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz.
lFlags
[in]: Reserviert Dieser Parameter muss 0 sein.
ppNewInstance
[out] Empfängt den Zeiger auf die neue Instanz der Klasse. Wenn ein Fehler auftritt, wird kein neues Objekt zurückgegeben, und ppNewInstance bleibt unverändert.
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_INCOMPLETE_CLASS |
0x80041020 | ptr ist keine gültige Klassendefinition und kann keine neuen Instanzen erzeugen. Entweder ist er unvollständig oder wurde nicht durch Aufrufen von PutClassWmi bei der Windows-Verwaltung registriert. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | ppNewClass ist null. |
WBEM_S_NO_ERROR |
0 | Der Funktionsaufruf war erfolgreich. |
Bemerkungen
Diese Funktion umschließt einen Aufruf der IWbemClassObject::SpawnInstance-Methode.
ptr muss eine Klassendefinition sein, die aus der Windows-Verwaltung abgerufen wurde. (Beachten Sie, dass das Erzeugen einer Instanz aus einer Instanz zwar unterstützt wird, dass die zurückgegebene Instanz jedoch leer ist.) Sie verwenden dann diese Klassendefinition, um neue Instanzen zu erstellen. Ein Aufruf der PutInstanceWmi-Funktion ist erforderlich, wenn Sie die Instanz in die Windows-Verwaltung schreiben möchten.
Das in ppNewClass zurückgegebene neue Objekt wird automatisch zu einer Unterklasse des aktuellen Objekts. Dieses Verhalten kann nicht außer Kraft gesetzt werden. Es gibt keine andere Methode, mit der Unterklassen (abgeleitete Klassen) erstellt werden können.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: WMINet_Utils.idl
.NET Framework-Versionen: Seit Version 4.7.2 verfügbar
