2-3
DSOM Framework Reference
get_next_response Function
Purpose
Returns the next Request object to complete, after starting multiple requests in parallel.
C Syntax
ORBStatus get_next_response (
Environment* env,
Flags response_flags,
Request *req );
Description
The get_next_response function returns a pointer to the next Request object to complete
after starting multiple requests in parallel. This is a synchronization function used in
conjunction with the send_multiple_requests function. There is no specific order in which
requests will complete.
If the response_flags field is set to 0, this function will not return until the next request
completion. If the caller does not want to become blocked, the RESP_NO_WAIT flag should
be specified.
Parameters
env A pointer to the Environment structure for the caller.
response_flags A Flags (unsigned long) variable, used to indicate whether the caller wants
to wait for the next request to complete (0), or not wait (RESP_NO_WAIT).
req A pointer to a Request object variable. The address of the next Request
object which completes is returned in the Request variable.
Return Value
The get_next_response function may return a non-zero ORBStatus value, which indicates
a DSOM error code. (See the SOM Toolkit User’s Guide for more information on DSOM
error codes.)
Example
See the example for the send_multiple_requests function.
Related Information
Functions: send_multiple_requests
Methods: send, get_response, invoke
This function is described in section 6.3, “Deferred Synchronous Routines”, of the CORBA
1.1 specification.
Kommentare zu diesen Handbüchern