IEventSystem::Query-Methode (eventsys.h)

Ruft eine Auflistung von Abonnement- oder Ereignisobjekten aus dem Ereignisdatenspeicher ab.

Syntax

HRESULT Query(
  [in]          BSTR     progID,
  [in]          BSTR     queryCriteria,
  [out]         int      *errorIndex,
  [out, retval] IUnknown **ppInterface
);

Parameter

[in] progID

Die ProgID der abzufragten Objektklasse. Dies muss ein gültiger Ereignisobjektklassenbezeichner sein. Dieser Parameter kann einer der folgenden Werte sein:

• PROGID_EventClass
• PROGID_EventClassCollection
• PROGID_EventSubscription
• PROGID_EventSubscriptionCollection

[in] queryCriteria

Die Abfragekriterien. Ausführliche Informationen zum Erstellen eines gültigen Ausdrucks für diesen Parameter finden Sie weiter unten im Abschnitt Hinweise.

[out] errorIndex

Die Position eines Fehlers im parameter queryCriteria , ausgedrückt als Offset.

[out, retval] ppInterface

Adresse eines Zeigers auf das Objekt, das als Ergebnis der Abfrage abgerufen wurde. Dieser Parameter darf nicht NULL sein. Abhängig vom objekt, das durch den progID-Parameter angegeben wird, ist dies ein Zeiger auf eine der folgenden Schnittstellen:

• IEventClass
• IEventObjectCollection
• IEventSubscription

Rückgabewert

Diese Methode kann die standardmäßigen Rückgabewerte E_INVALIDARG, E_POINTER, E_OUTOFMEMORY, E_UNEXPECTED und E_FAIL sowie die folgenden Werte zurückgeben.

Hinweise

Der Aufrufer ist für das Freigeben von Arbeitsspeicher verantwortlich, der über den ppInterface-Parameter zugewiesen wurde.

Die durch den parameter queryCriteria angegebenen Abfragekriterien können "ALL" sein, um eine Anforderung für alle Abonnementobjekte anzugeben, oder ein boolescher Ausdruck, der eine oder mehrere Bedingungen angibt, die ein Abonnementobjekt erfüllen muss, um in das Abfrageergebnis eingeschlossen zu werden. Gültige Ausdrücke haben die folgende Form:

[NICHT] propertynamerelationalOperator-Wert. Gültige relationale Operatoren sind wie folgt:

==, =, !=, <>, ~=. Gültige Werte sind "string", "string", {GUID}, TRUE, FALSE, NULL.

Einzelne boolesche Ausdrücke können mit AND oder OR verknüpft werden. Ausdrücke können in Klammern geschachtelt werden, um eine bestimmte Auswertungsreihenfolge zu erzwingen.

Im Folgenden sind einige Beispiele für gültige Abfragekriterien aufgeführt:

"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF}"

"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} AND MethodName = 'StockPriceChange'"

Anforderungen

Weitere Informationen

IEventSystem