RegisterForEvent(const char *, const char *, const char *, bool)-Methode

RegisterForEvent(const char , const char , const char *, bool)-Methode

Registriert eine Warteschlange, um Benachrichtigungen für ein Ereignis zu empfangen, oder macht diese Registrierung rückgängig.

Syntax

public virtual bool RegisterForEvent(
    const char * eventName,
    const char * objectName,
    const char * queueName,
    bool register_not_unreg
)

Parameter

eventName Vom System oder vom Benutzer definiertes Ereignis, für das eine Registrierung erfolgen soll.
objectName Objekt, auf das das Ereignis anzuwenden ist (etwa ein Tabellenname).
queueName NULL steht für eine Standard-Verbindungswarteschlange.
register_not_unreg True, um zu registrieren. False, um zu deregistrieren.

Wenn kein Warteschlangenname geliefert wird, wird die Standard-Verbindungswarteschlange angenommen und ggf. erstellt. Bestimmte Systemereignisse lassen die Angabe eines Objektnamens zu, für den das Ereignis gilt. Das TableModified-Ereignis z.B. kann den Tabellennamen spezifizieren. Im Gegensatz zu SendNotification() empfängt nur die jeweilige registrierte Warteschlange Benachrichtigungen des Ereignisses. Andere Warteschlangen mit demselben Namen auf anderen Verbindungen erhalten die Benachrichtigungen nicht, außer wenn sie ebenfalls registriert sind.

Die vordefinierten Systemereignisse sind:

TableModified Wird ausgelöst, wenn Zeilen in einer Tabelle eingefügt, aktualisiert oder gelöscht werden. Eine Benachrichtigung wird pro Anforderung gesendet, unbeschadet der Anzahl der durch die Anforderung betroffenen Zeilen. Der Parameter object_name gibt die zu überwachende Tabelle an. Der Wert "*" steht für alle Tabellen in der Datenbank. Dieses Ereignis hat einen Parameter namens 'table_name', dessen Wert der Name der geänderten Tabelle ist.
Commit Wird ausgelöst, nachdem ein Festschreibvorgang abgeschlossen ist. Dieses Ereignis hat keine Parameter.
SyncComplete Wird ausgelöst, nachdem die Synchronisation abgeschlossen ist. Dieses Ereignis hat keine Parameter.

Kommentieren Sie diese Seite in DocCommentXchange.

RegisterForEvent(const char , const char , const char *, bool)-Methode

Syntax

Parameter

Rückgabe

Bemerkungen