The ECI_GET_SPECIFIC_REPLY_WAIT call type provides a reply solicitation
call to return information appropriate to any outstanding reply that
matches the input eci_message_qualifier.
Environment
Purpose
If there is no such reply, the
application waits until there is. (You can get an indication that
no reply is available by using call type ECI_GET_SPECIFIC_REPLY instead.)
Note: It is important that the ECI parameter blocks of outstanding
ECI_STATE_ASYNC calls are not modified before the results of the call
are received. Results will be incorrect if these blocks are modified
before this stage.
ECI parameter block fields
Same as for
ECI_GET_SPECIFIC_REPLY, but eci_call_type must
be set to ECI_GET_SPECIFIC_REPLY_WAIT.
Return codes
Same as for ECI_GET_SPECIFIC_REPLY,
except that ECI_ERR_NO_REPLY cannot be returned.
Note: If
you issue an ECI_GET_SPECIFIC_REPLY_WAIT call against an outstanding
ECI_STATE_AYSNC call with eci_extend mode set to ECI_STATE_CHANGED,
no response will ever be received if an ECI_STATE_ASYNC call with eci_extend_mode set
to ECI_STATE_CANCEL is issued.