IWbemObjectSink-Schnittstelle

Die IWbemObjectSink-Schnittstelle erstellt eine Senkenschnittstelle, die alle Arten von Benachrichtigungen innerhalb des WMI-Programmiermodells empfangen kann. Clients müssen diese Schnittstelle implementieren, um sowohl die Ergebnisse der asynchronen Methoden von IWbemServices als auch bestimmte Arten von Ereignisbenachrichtigungen zu empfangen. Anbieter verwenden diese Schnittstelle, um Ereignisse und Objekte für WMI bereitzustellen, implementieren sie jedoch nicht.

In der Regel rufen Anbieter eine Implementierung auf, die ihnen von WMI bereitgestellt wird. Rufen Sie in diesen Fällen Indicate auf, um Objekte für den WMI-Dienst bereitzustellen. Rufen Sie danach SetStatus auf, um das Ende der Benachrichtigungssequenz anzugeben. Sie können auch SetStatus aufrufen, um Fehler anzuzeigen, wenn die Senke keine Objekte enthält.

Beim Programmieren asynchroner Clients von WMI stellt der Benutzer die Implementierung bereit. WMI ruft die Methoden auf, um Objekte zu übermitteln und den Status des Ergebnisses festzulegen.

Hinweis

Wenn eine Clientanwendung dieselbe Senkenschnittstelle in zwei verschiedenen überlappenden asynchronen Aufrufen übergibt, garantiert WMI nicht die Reihenfolge des Rückrufs. Clientanwendungen, die überlappende asynchrone Aufrufe ausführen, sollten entweder verschiedene Senkenobjekte übergeben oder die Aufrufe serialisieren.

Hinweis

Da der Rückruf an die Senke möglicherweise nicht auf der Authentifizierungsebene zurückgegeben wird, die der Client benötigt, empfiehlt es sich, anstelle der asynchronen Kommunikation eine halbsynchrone Kommunikation zu verwenden. Weitere Informationen finden Sie unter Aufrufen einer Methode.

Member

Die IWbemObjectSink-Schnittstelle weist drei Typen von Membern auf:

• Methoden

Methoden

Die IWbemObjectSink-Schnittstelle weist diese Methoden auf.

Methode	BESCHREIBUNG
Indicate	Empfängt Benachrichtigungsobjekte.
SetStatus	Wird von Quellen aufgerufen, um das Ende einer Benachrichtigungssequenz anzugeben oder andere Statuscodes an die Senke zu senden.

Bemerkungen

Führen Sie beim Implementieren einer Ereignisabonnementsenke (IWbemObjectSink oder IWbemEventSink) keinen Aufruf von WMI aus den Methoden Indicate oder SetStatus für das Senkenobjekt aus. Beispielsweise kann der Aufruf von IWbemServices::CancelAsyncCall zum Kündigen der Senke innerhalb einer Implementierung von Indicate zu Konflikten mit dem WMI-Zustand führen. Legen Sie zum Kündigen eines Ereignisabonnements ein Flag fest, und rufen Sie IWbemServices::CancelAsyncCall aus einem anderen Thread oder Objekt auf. Für Implementierungen, die sich nicht auf eine Ereignissenke beziehen, z. B. Objekt-, Enumerations- und Abfrageabrufe, können Sie Rückrufe an WMI ausführen.

Senkenimplementierungen sollten die Ereignisbenachrichtigung innerhalb von 100 ms verarbeiten, da der WMI-Thread, der die Ereignisbenachrichtigung übermittelt, keine anderen Aufgaben ausführen kann, bis das Senkenobjekt die Verarbeitung abgeschlossen hat. Wenn die Benachrichtigung einen großen Verarbeitungsumfang erfordert, kann die Senke eine interne Warteschlange für einen anderen Thread verwenden, um die Verarbeitung auszuführen.

Beispiele

Das folgende Codebeispiel ist eine einfache Implementierung einer Objektsenke. Dieses Beispiel kann mit IWbemServices::ExecQueryAsync oder IWbemServices::CreateInstanceEnumAsync verwendet werden, um die zurückgegebenen Instanzen zu empfangen:

#include <iostream>
#include <wbemidl.h>
#pragma comment(lib, "wbemuuid.lib")

class QuerySink : public IWbemObjectSink
{
    LONG m_lRef;
    bool bDone; 

public:
    QuerySink() { m_lRef = 0; }
   ~QuerySink() { bDone = TRUE; }

    virtual ULONG STDMETHODCALLTYPE AddRef();
    virtual ULONG STDMETHODCALLTYPE Release();        
    virtual HRESULT STDMETHODCALLTYPE 
        QueryInterface(REFIID riid, void** ppv);

    virtual HRESULT STDMETHODCALLTYPE Indicate( 
            /* [in] */
            LONG lObjectCount,
            /* [size_is][in] */
            IWbemClassObject __RPC_FAR *__RPC_FAR *apObjArray
            );
        
    virtual HRESULT STDMETHODCALLTYPE SetStatus( 
            /* [in] */ LONG lFlags,
            /* [in] */ HRESULT hResult,
            /* [in] */ BSTR strParam,
            /* [in] */ IWbemClassObject __RPC_FAR *pObjParam
            );
};


ULONG QuerySink::AddRef()
{
    return InterlockedIncrement(&m_lRef);
}

ULONG QuerySink::Release()
{
    LONG lRef = InterlockedDecrement(&m_lRef);
    if(lRef == 0)
        delete this;
    return lRef;
}

HRESULT QuerySink::QueryInterface(REFIID riid, void** ppv)
{
    if (riid == IID_IUnknown || riid == IID_IWbemObjectSink)
    {
        *ppv = (IWbemObjectSink *) this;
        AddRef();
        return WBEM_S_NO_ERROR;
    }
    else return E_NOINTERFACE;
}


HRESULT QuerySink::Indicate(long lObjCount, IWbemClassObject **pArray)
{
    for (long i = 0; i < lObjCount; i++)
    {
        IWbemClassObject *pObj = pArray[i];

        // ... use the object.

        // AddRef() is only required if the object will be held after
        // the return to the caller.
    }

    return WBEM_S_NO_ERROR;
}

HRESULT QuerySink::SetStatus(
            /* [in] */ LONG lFlags,
            /* [in] */ HRESULT hResult,
            /* [in] */ BSTR strParam,
            /* [in] */ IWbemClassObject __RPC_FAR *pObjParam
        )
{
    printf("QuerySink::SetStatus hResult = 0x%X\n", hResult);
    return WBEM_S_NO_ERROR;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Header	Wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Fastprox.dll

Weitere Informationen

COM-API für WMI

Durchführen eines asynchronen Aufrufs mit C++

Festlegen der Sicherheit für einen asynchronen Aufruf

Empfangen von Ereignissen für die Dauer Ihrer Anwendung