IMultiInterfaceEventControl::SetDefaultQuery-Methode (eventsys.h)
Richtet eine Standardabfrage ein, die verwendet werden soll, wenn ein Herausgeberfilter keiner Ereignismethode zugeordnet ist.
Syntax
HRESULT SetDefaultQuery(
[in] REFIID eventIID,
[in] BSTR bstrMethodName,
[in] BSTR bstrCriteria,
[out, retval] int *errorIndex
);
Parameter
[in] eventIID
Der Schnittstellenbezeichner der ausgelösten Schnittstelle.
[in] bstrMethodName
Der Name der Methode, der die Standardabfrage zugewiesen ist.
[in] bstrCriteria
Eine Zeichenfolge, die die Abfragekriterien angibt. Dieser Parameter darf nicht NULL sein. Ausführliche Informationen zum Erstellen eines gültigen Ausdrucks für diesen Parameter finden Sie weiter unten im Abschnitt Hinweise.
[out, retval] errorIndex
Die Position eines Fehlers im bstrCriteria-Parameter , ausgedrückt als Offset.
Rückgabewert
Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED und E_FAIL sowie die folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Beim Auswerten einer Abfragezeichenfolge ist ein Syntaxfehler aufgetreten. |
|
In einer Abfragezeichenfolge wurde ein ungültiger Feldname verwendet. |
|
Eine unerwartete Ausnahme wurde ausgelöst. |
|
Ein unerwarteter interner Fehler wurde erkannt. |
Hinweise
Diese Methode ist eine spezialisiertere Form der IEventSystem::Query-Methode . Zusätzlich zum Abrufen von nur Abonnementobjekten wird eine Sammlung, die durch Aufrufen von GetSubscriptions abgerufen wird, automatisch aktualisiert, wenn sich die Abonnementauflistung ändert.
Die durch den bstrCriteria-Parameter 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 Reihenfolge der Auswertung zu erzwingen.
Im Folgenden sind einige Beispiele für gültige Abfragekriterien aufgeführt:
"EventClassID == {F89859D1-6565-11D1-88C8-0080C771BF}"
"EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} AND MethodName = 'StockPriceChange'"
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eventsys.h |