RegisterForEvent-Funktion

Registriert (eine Warteschlange) für Benachrichtigungen über ein Ereignis oder hebt die Registrierung auf.

Syntax

bool UltraLite_Connection_iface::RegisterForEvent(
  const ULValue & event_name,
  const ULValue & object_name,
  const ULValue & queue_name,
  bool register_not_unreg
)

Parameter

event_name Vom System oder vom Benutzer definiertes Ereignis, für das eine Registrierung erfolgen soll
object_name Objekt, auf das das Ereignis anzuwenden ist (etwa ein Tabellenname)
queue_name NULL steht für eine Standard-Verbindungswarteschlange
register_not_unreg TRUE, um zu registrieren, FALSE, um die Registrierung zu löschen

Rückgabe

TRUE, wenn die Registrierung erfolgreich war, und FALSE, wenn die Warteschlange oder das Ereignis nicht existiert.

Bemerkungen

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-Funktion empfängt nur die spezifische registrierte Warteschlange Benachrichtigungen des Ereignisses, andere Warteschlangen mit demselben Namen bei anderen Verbindungen erhalten keine (außer sie sind auch explizit registriert).

Die vordefinierten Systemreignisse 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.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.
Senden Sie uns Feedback über diese Seite via E-Mail.