IWbemServices::D eleteInstanceAsync-Methode (wbemcli.h)

  • Artikel

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.

Hinweis Clients, die DeleteInstanceAsync aufrufen, müssen immer erwarten, dass die Ergebnisse des Aufrufs mithilfe ihrer IWbemObjectSink::Indicate-Methode gemeldet werden.
 
Hinweis Wenn die instance, auf die strObjectPath verweist, zu einer Klasse gehört, die ein Member einer Klassenhierarchie ist, hängt der Erfolg von DeleteInstanceAsync vom obersten nicht abstrakten Anbieter ab. Eine ausführliche Erläuterung der beteiligten Abhängigkeiten, die den Erfolg dieses Vorgangs bestimmen, finden Sie unter Hinweise in IWbemServices::D eleteInstance.
 

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

Weitere Informationen

Aufrufen einer Methode

Beschreiben eines Instanzobjektpfads

IWbemServices

IWbemServices::DeleteInstance