Provider::D eleteInstance(ParsedObjectPath*,long,MethodContext*)-Methode (provider.h)

[Die Provider-Klasse ist Teil des WMI-Provider-Frameworks, das nun als endgültig betrachtet wird, und es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]

Die DeleteInstance-Methode wird von WMI aufgerufen, um eine instance zu löschen.

Syntax

HRESULT DeleteInstance(
  ParsedObjectPath *pParsedObjectPath,
  long             lFlags,
  MethodContext    *pContext
);

Parameter

pParsedObjectPath

TBD

lFlags

Bitmaske von Flags mit Informationen zum Löschvorgang. Dies ist der Wert, der vom Client in der Funktion IWbemServices::D eleteInstance angegeben wird.

Das folgende Flag wird von WMI behandelt (und herausgefiltert):

• WBEM_FLAG_RETURN_IMMEDIATELY

pContext

TBD

Rückgabewert

Die Standardframeworkanbieterimplementierung dieser Methode gibt WBEM_E_PROVIDER_NOT_CAPABLE an die aufrufende Funktion zurück. Die Funktion IWbemServices::D eleteInstance listet die gängigsten Rückgabewerte auf, obwohl Sie einen beliebigen COM-Rückgabecode zurückgeben können.

Hinweise

WMI ruft DeleteInstance auf, wenn ein Client IWbemServices::D eleteInstance für eine Klasse aufruft. Daher müssen Sie DeleteInstance implementieren, wenn Ihr Frameworkanbieter das Löschen von Instanzen unterstützt. In der folgenden Liste wird eine allgemeine Implementierung von DeleteInstance beschrieben:

1. Ermitteln Sie, welche instance der Client angefordert hat, indem Sie die Schlüsseleigenschaften mit einer der Get-Methoden für CInstance lesen, z. B. CInstance::GetCHString.
2. Löschen Sie die instance.

Anforderungen