|
| bool | pn_condition_is_set (pn_condition_t *condition) |
| | Returns true if the condition object is holding some information, i.e.
|
| |
| void | pn_condition_clear (pn_condition_t *condition) |
| | Clears the condition object of any exceptional information.
|
| |
| const char * | pn_condition_get_name (pn_condition_t *condition) |
| | Returns the name associated with the exceptional condition, or NULL if there is no conditional information set.
|
| |
| int | pn_condition_set_name (pn_condition_t *condition, const char *name) |
| | Sets the name associated with the exceptional condition.
|
| |
| const char * | pn_condition_get_description (pn_condition_t *condition) |
| | Gets the description associated with the exceptional condition.
|
| |
| int | pn_condition_set_description (pn_condition_t *condition, const char *description) |
| | Sets the description associated with the exceptional condition.
|
| |
| pn_data_t * | pn_condition_info (pn_condition_t *condition) |
| | Returns a data object that holds the additional information associated with the condition.
|
| |
|
int | pn_condition_vformat (pn_condition_t *, const char *name, const char *fmt, va_list ap) |
| | Set the name and printf-style formatted description.
|
| |
|
int | pn_condition_format (pn_condition_t *, const char *name, PN_PRINTF_FORMAT const char *fmt,...) PN_PRINTF_FORMAT_ATTR(3 |
| | Set the name and printf-style formatted description.
|
| |
| int bool | pn_condition_is_redirect (pn_condition_t *condition) |
| | Returns true if the condition is a redirect.
|
| |
| const char * | pn_condition_redirect_host (pn_condition_t *condition) |
| | Retrieves the redirect host from the additional information associated with the condition.
|
| |
| int | pn_condition_redirect_port (pn_condition_t *condition) |
| | Retrieves the redirect port from the additional information associated with the condition.
|
| |
|
int | pn_condition_copy (pn_condition_t *dest, pn_condition_t *src) |
| | Copy the src condition to the dst condition.
|
| |
|
pn_condition_t * | pn_condition (void) |
| | Create a condition object.
|
| |
|
void | pn_condition_free (pn_condition_t *) |
| | Free a condition object.
|
| |
An endpoint error state.
An AMQP Condition object.
Conditions hold exception information pertaining to the closing of an AMQP endpoint such as a Connection, Session, or Link. Conditions also hold similar information pertaining to deliveries that have reached terminal states. Connections, Sessions, Links, and Deliveries may all have local and remote conditions associated with them.
The local condition may be modified by the local endpoint to signal a particular condition to the remote peer. The remote condition may be examined by the local endpoint to detect whatever condition the remote peer may be signaling. Although often conditions are used to indicate errors, not all conditions are errors per/se, e.g. conditions may be used to redirect a connection from one host to another.
Every condition has a short symbolic name, a longer description, and an additional info map associated with it. The name identifies the formally defined condition, and the map contains additional information relevant to the identified condition.
1.9.7