ULSendNotificationW method

Sends a notification to all queues matching the given name.

Syntax

public ul_u_long ULSendNotificationW(
    SQLCA * sqlca,
    ul_wchar const * queue_name,
    ul_wchar const * event_name,
    ul_wchar const * parameters
)

Parameters

sqlca A pointer to the SQLCA.
queue_name NULL means default connection queue.
event_name The system or user-defined event to register for.
parameters Creation parameters; currently unused, set to NULL.

Note

This method prototype is used internally when you refer to ULSendNotification and #define the UNICODE macro on Win32 platforms. Typically, you would not reference this method directly when creating an UltraLite application.

This includes any such queue on the current connection. This call does not block. Use the special queue name "*" to send to all queues. The given event name does not need to correspond to any system or user-defined event; it is simply passed through to identify the notification when read and has meaning only to the sender and receiver. The parameters argument specifies a semi-colon delimited name=value pairs option list. After the notification is read, the parameter values are read with GetNotificationParameter().

Discuss this page in DocCommentXchange.