10
AltiAgent ActiveX Programmer’s Guide
SetURLData
Description
Set URL data for existing call (used only in Web call). When a call comes to a Web site, it can
contain URL data such as “http://www.altigen.com,” so that the user application can know where
this call comes from.
Note
SetURLData is a reserved API.
VC++ Syntax
BOOL SetURLData(int SessionID,BSTR string)
VB Syntax
object.SetURLData(SessionID,string)
Parameters
SessionID [In]: unique ID for a call
String [In] Set URL data for a call; maximum length is 256 bytes.
Return Type
BOOL - if successful TRUE; otherwise FALSE
Remark
SessionID - Session ID received from OnCallNotify event needs to be provided as input to this
function. This Session ID is valid in ring event and connect event. After Disconnect event, it is no
longer valid.
VC++ Example
CComBSTR bstrData = _T("url data");
m_altictrl. SetURLData (ulSessionID, bstrData);
VB Example
Dim data As String
Data = "url data"
If (AltiCtrl1.SetURLData(ulSessionID, data) = False) Then
...
Else
...
End If
GetURLData
Description
Get URL data for existing call
VC++ Syntax
BSTR GetURLData(int SessionID)