Most of the webMethods Broker library functions are designed to return a BrokerError pointer. The webMethods Broker system has one global error per thread that is considered to be the current error. The system manages the memory associated with the current error. If your application copies the current error, remember that you are responsible for freeing the memory associated with those copies.

The BrokerError contains an indication of the success or failure of the function call. If the function call has returned without an error, NULL will be returned. The following example shows how to test for an error after an webMethods Broker library (awNewBrokerClient) function call: