Freigeben über

IEventSystem::Remove-Methode (eventsys.h)

  • Artikel

Entfernt mindestens ein Abonnement- oder Ereignisobjekt aus dem Ereignisdatenspeicher.

Syntax

HRESULT Remove(
  [in]  BSTR progID,
  [in]  BSTR queryCriteria,
  [out] int  *errorIndex
);

Parameter

[in] progID

Die ProgID der zu entfernenden 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 queryCriteria-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
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
EVENT_E_QUERYSYNTAX
 Beim Auswerten einer Abfragezeichenfolge ist ein Syntaxfehler aufgetreten.
EVENT_E_QUERYFIELD
 In einer Abfragezeichenfolge wurde ein ungültiger Feldname verwendet.
EVENT_E_NOT_ALL_REMOVED
 Nicht alle angeforderten Objekte konnten entfernt werden.

Hinweise

Die vom queryCriteria-Parameter angegebenen Abfragekriterien können "ALL" sein, um eine Anforderung für alle Abonnementobjekte anzugeben, oder einen booleschen 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

Weitere Informationen

IEventSystem