ULGetNotificationW-Methode

Liest eine Ereignisbenachrichtigung.

Syntax

public ul_bool ULGetNotificationW(
    SQLCA * sqlca,
    ul_wchar const * queue_name,
    ul_wchar * event_name_buf,
    ul_length event_name_buf_len,
    ul_u_long wait_ms
)

Parameter

sqlca Ein Zeiger auf den SQLCA-Bereich
queue_name Zu lesende Warteschlange oder NULL für Standard-Verbindungswarteschlange.
event_name_buf Ein Puffer für die Aufnahme des Ereignisnamens.
event_name_buf_len Die Größe des Puffers in ul_wchars.
wait_ms Abzuwartende Zeitspanne (Blockierung) vor der Rückgabe.

Hinweis

Dieser Methodenprototyp wird intern verwendet, wenn Sie ULGetNotification referenzieren und den UNICODE-Makro auf Win-Plattformen definieren. In der Regel referenzieren Sie diese Methode nicht direkt bei der Erstellung einer UltraLite-Anwendung.

Dieser Aufruf blockiert, bis eine Benachrichtigung empfangen wird oder die angegebene Wartezeit abgelaufen ist. Für eine unbegrenzte Wartezeit übergeben Sie UL_READ_WAIT_INFINITE für wait_ms. Um den Wartezustand zu beenden, senden Sie eine weitere Benachrichtigung an die Warteschlange oder verwenden Sie CancelGetNotification(). Nach dem Lesen der Benachrichtigung verwenden Sie ReadNotificationParameter(), um zusätzliche Parameter nach Namen abzurufen.

Kommentieren Sie diese Seite in DocCommentXchange.