WaitForCall(String,String) Method

In This Topic

Initializes the modem to automatically answer an incoming call and opens a status dialog box until a connection has been established.

Syntax

Visual Basic
C#

'Declaration
 
Overloads Function WaitForCall( _
   ByVal description As String, _
   ByVal initString As String _
) As ReturnCode

'Usage
 
Dim instance As ITerminal
Dim description As String
Dim initString As String
Dim value As ReturnCode
 
value = instance.WaitForCall(description, initString)

ReturnCode WaitForCall( 
   string description,
   string initString
)

Parameters

description: Specifies a message to be displayed in the Waiting for Call dialog box.
initString: Specifies an initialization string to be sent to the modem before waiting.

Return Value

ReturnCode value indicates success or error conditions.

Remarks

This method does not check to see whether a modem is actually connected to the serial port. It simply transmits the Hayes "AT" command to get the modem's attention, and then transmits the "ATS0=1" command to place the modem in answer mode. If the command fails for any reason, no error is returned. The procedure continues to the next statement only after the status box is dismissed (either because the modem established a connection, the user canceled, or the dialog box timed out).

Reference

ITerminal Interface
ITerminal Members
Overload List

Send Feedback