ECI_GET_SPECIFIC_REPLY_WAIT call type

Environment

Purpose

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. 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.