Dialer SDK > Implementation details > Dialing provider API > ISampleManagementProvider > Return
 
Return
Syntax
Return(SampleManagementName As String, SampleRecordXml As String, ReturnCodeXml As String, PropertiesXml As String, Optional QuotaEngine as Variant) As SampleManagementResultXml
Type
Method
Parameters
SampleManagementName
The name of the sample management object.
SampleRecordXml
The sample record to return as XML.
ReturnCodeXml
The return code as XML.
PropertiesXml
The project, interview, interviewer, and station properties as SampleManagementXml.
QuotaEngine
Optional. A QuotaEngine for the project.
Return value
SampleManagementResultXml
Description
This method is called when the interviewer selects a return code for a connected or manually dialed call. This description assumes group dialing and an implementation where the predictive algorithm is implemented by the dialer.
1 Hang up if not a timeout or shutdown and connected. A timeout occurs if the interviewer stays on the same page for a long period of time. Timeouts cause the interview objects to be unloaded to save resources. Avoid hang up on shutdown in case the shutdown is caused by an application pool shutdown. The interview may fail over to a new session engine so we do not want to hangup the call with the respondent.
2 Send the return code to the dialer if necessary for dialer specific reports.
3 Call the specific sample management provider’s Return method to return the sample record.
See also
ISampleManagementProvider