Provider::D eleteInstance(constCInstance&,long)-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(
[ref] const CInstance & newInstance,
long lFlags
);
Parameter
[ref] newInstance
Zu löschende Instanz.
lFlags
Bitmaske von Flags mit Informationen zum Löschvorgang. Dies ist der vom Client in der Funktion IWbemServices::D eleteInstance angegebene Wert.
Das folgende Flag wird von WMI behandelt (und herausgefiltert):
- WBEM_FLAG_RETURN_IMMEDIATELY
Rückgabewert
Die Standardframeworkanbieterimplementierung dieser Methode gibt WBEM_E_PROVIDER_NOT_CAPABLE an die aufrufende Funktion zurück. Die IWbemServices::D eleteInstance-Funktion listet die häufigsten 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 gängige Implementierung von DeleteInstance beschrieben:
- Ermitteln Sie, welche instance der Client angefordert wird, 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 (einschließlich FwCommon.h) |
| Bibliothek | FrameDyn.lib |
| DLL | FrameDynOS.dll; FrameDyn.dll |