Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | API Reference | awDescriptor | awDescriptorToString
 
awDescriptorToString
char * awDescriptorToString(
BrokerConnectionDescriptor desc);
desc
The connection descriptor to be converted.
Returns the values of the connection descriptor desc in a string form suitable for display on a computer screen. The caller is responsible for freeing the memory associated with the return value.
Returns NULL if the desc is invalid or if memory could not be allocated.
Possible BrokerError major codes
Meaning
AW_ERROR_INVALID_CLIENT
The client is not valid.
AW_ERROR_INVALID_CLIENT_ID
The destination ID contains illegal characters.
AW_ERROR_INVALID_EVENT
The event is not valid, or if the event does not match its type definition.
AW_ERROR_NO_PERMISSION
The client does not have permission to publish the event type.
AW_ERROR_NULL_PARAM
The dest_id is NULL.
AW_ERROR_OUT_OF_RANGE
n is less than zero.
AW_ERROR_UNKNOWN_EVENT_TYPE
The event type for the event does not exist on the Broker.
In addition, any of the communications errors can occur.
See also: