ULGetNotificationParameterW method

Gets a parameter for the event notification just read by GetNotification().

Syntax

public ul_bool ULGetNotificationParameterW(
    SQLCA * sqlca,
    ul_wchar const * queue_name,
    ul_wchar const * parameter_name,
    ul_wchar * value_buf,
    ul_length value_buf_len
)

Parameters

sqlca A pointer to the SQLCA.
queue_name The queue to read or NULL for default connection queue.
parameter_name The name of the parameter to read (or "*").
value_buf A buffer to hold the parameter value.
value_buf_len The size of the buffer in ul_wchars.

Note

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

Only the parameters from the most-recently read notification on the given queue are available. Parameters are retrieved by name. A parameter name of "*" retrieves the entire parameter string.

Discuss this page in DocCommentXchange.