SpawnInstance-Funktion

  • Artikel

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

Weitere Informationen