Since a provider may allocate some resources on behalf of a consumer handle outside the Java virtual machine, clients should close them when they are not needed. Relying on garbage collection to eventually reclaim these resources may not be timely enough.
This call blocks until a receive or message listener in progress has completed. A blocked message consumer receive call returns null when this message consumer is closed.
Sets a message listener function associated with this consumer The message passed into the listener function is destroyed by the system after the listener function returns. Hence the message should not be freed by the listener function and should not be referenced after the listener function returns
Must be a valid consumer handle. May not be NULL
The function that should be called in the event a message arrives for this consumer. The message passed into the function will normally be freed by the system when the function returns (see flags). The second parameter will be the argument passed to this function.
An optional argument that can be passed to this message listener function when called by the system. This argument can be used for any purpose by the application.
JMS_APPLICATION_MUST_FREE_HANDLE should be set if the message handle given to the listener function should not be freed by the system when the function returns. The flags value (plus the JMS_CALLED_FROM_JMS flag) will be passed to the listener function as its flags input parameter on every invokation.
Contact OracleLegal Notices
Copyright 1996,2011. Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
Oracle Fusion Middleware
Oracle WebLogic Server JMS C API Reference
11g Release 1 (10.3.5)