IWbemServices::D eleteInstanceAsync-Methode (wbemcli.h)
Die IWbemServices::D eleteInstanceAsync-Methode löscht asynchron eine instance einer vorhandenen Klasse im aktuellen Namespace. Die Bestätigung oder der Fehler des Vorgangs wird über die vom Aufrufer implementierte IWbemObjectSink-Schnittstelle gemeldet.
Syntax
HRESULT DeleteInstanceAsync(
[in] const BSTR strObjectPath,
[in] long lFlags,
[in] IWbemContext *pCtx,
[in] IWbemObjectSink *pResponseHandler
);
Parameter
[in] strObjectPath
Gültiger BSTR , der den Objektpfad des zu löschenden Objekts enthält.
[in] lFlags
WBEM_FLAG_SEND_STATUS registriert bei der Windows-Verwaltung eine Anforderung zum Empfangen von zwischengeschalteten status Berichten über die Implementierung von IWbemObjectSink::SetStatus des Clients. Die Anbieterimplementierung muss zwischengeschaltete status Berichterstellung unterstützen, damit dieses Flag das Verhalten ändert. Beachten Sie, dass das flag WBEM_FLAG_USE_AMENDED_QUALIFIERS hier nicht verwendet werden kann.
[in] pCtx
In der Regel NULL. Andernfalls ist dies ein Zeiger auf ein IWbemContext-Objekt, das von dem Anbieter verwendet werden kann, der die instance löscht. Die Werte im Kontextobjekt müssen in der Dokumentation für den betreffenden Anbieter angegeben werden.
[in] pResponseHandler
Zeiger auf die Implementierung von IWbemObjectSink des Aufrufers. Dieser Handler empfängt die status des Löschvorgangs, sobald er über die SetStatus-Methode verfügbar wird. Wenn ein Fehlercode zurückgegeben wird, wird der angegebene IWbemObjectSink-Zeiger nicht verwendet. Wenn WBEM_S_NO_ERROR zurückgegeben wird, wird die IWbemObjectSink-Implementierung des Benutzers aufgerufen, um das Ergebnis des Vorgangs anzugeben. Die Windows-Verwaltung ruft AddRef nur für den Zeiger auf, wenn WBEM_S_NO_ERROR zurückgegeben wird. In Fällen, in denen ein Fehlercode zurückgegeben wird, ist die Verweisanzahl identisch mit der beim Eintrag. Weitere Informationen finden Sie unter Aufrufen einer Methode.
Rückgabewert
Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.
Bei einem Fehler können Sie alle verfügbaren Informationen über die COM-Funktion GetErrorInfo abrufen.
Wenn DeleteInstanceAsyncWBEM_S_NO_ERROR zurückgibt, wartet WMI auf ein Ergebnis der SetStatus-Methode des Antworthandlers. WMI wartet unbegrenzt auf eine lokale Verbindung oder bis zu einem Timeout für Remoteverbindungen.
Andere Fehlerbedingungen werden asynchron an die Objektsenke gemeldet, die vom pResponseHandler-Parameter bereitgestellt wird.
COM-spezifische Fehlercodes können auch zurückgegeben werden, wenn Netzwerkprobleme dazu führen, dass die Remoteverbindung mit der Windows-Verwaltung verloren geht.
Hinweise
Ein instance-Anbieter kann entweder mit dem Rückgabecode von DeleteInstanceAsync oder über einen Aufruf von SetStatus über pResponseHandler Erfolg oder Fehler melden. Wenn sie an SetStatus gesendet wird, hat der rückgabecode, der über pResponseHandler an die Senke gesendet wird, Vorrang. Da der Rückruf möglicherweise nicht auf derselben Authentifizierungsebene zurückgegeben wird, wie es für den Client erforderlich ist, wird empfohlen, die semisynchrone anstelle der asynchronen Kommunikation zu verwenden. Wenn Sie asynchrone Kommunikation benötigen, finden Sie weitere Informationen unter Aufrufen einer Methode.
Weitere Informationen zur semisynchronen Verwendung von Methoden finden Sie unter IWbemServices::D eleteInstance und Aufrufen einer Methode.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | wbemcli.h (include Wbemidl.h) |
| Bibliothek | Wbemuuid.lib |
| DLL | Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll |