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:
- 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.
- Löschen Sie die instance.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista |
Unterstützte Mindestversion (Server) | Windows Server 2008 |
Zielplattform | Windows |
Kopfzeile | provider.h (schließen Sie FwCommon.h ein) |
Bibliothek | FrameDyn.lib |
DLL | FrameDynOS.dll; FrameDyn.dll |