IEventControl::SetDefaultQuery-Methode (eventsys.h)

Legt die Standardabfrage fest, um Abonnenten zu bestimmen.

Syntax

HRESULT SetDefaultQuery(
  [in]          BSTR methodName,
  [in]          BSTR criteria,
  [out, retval] int  *errorIndex
);

Parameter

[in] methodName

Der Name der Methode, der die Standardabfrage zugewiesen ist.

[in] criteria

Die Abfragekriterien. 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 Criteria-Parameter , ausgedrückt als Offset.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die durch den Criteria-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 aufgenommen 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

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

Weitere Informationen

IEventControl