mCore™ .NET SMS Library 1.2

mCore.SMS.CancelUSSDSession Method

Description:

The CancelUSSDSession terminates currently active USSD session (if any) and returns the result of the method as a Boolean value (True if cancel session is successful). The status of current USSD session can be determined by evaluating the status property of NewUSSDReceivedEventArgs object returned by the NewUSSDReceived event.

Namespace: mCore
Assembly: mCoreLib (in mCoreLib.dll)

Remarks:

USSD (Unstructured Supplementary Service Data) is a Global System for Mobile(GSM) communication technology that is used to send text between a mobile phone and an application program in the network. Applications may include prepaid roaming or mobile chatting.
USSD is similar to Short Messaging Service (SMS), but,unlike SMS, USSD transactions occur during the session only.
Incoming USSD messages arrive in asynchronous manner and can be read using the NewUSSDReceived event.

Exceptions:

mCore.GeneralException

Usage Example:

Visual Basic

Public Class MyClass
   Public WithEvents objSMS As New mCore.SMS

   Public Sub New()
      Try
         SetCommParameters()
         objSMS.NewUSSDIndication = True
         objSMS.SendUSSD("*101#")
      Catch ex As mCore.GeneralException
         MsgBox(ex.Message)
      End Try
   End Sub

   'New USSD Message Event Handling
   'A message box will pop-up whenever
   'a new USSD message is received
   Private Sub objSMS_NewUSSDReceived(ByVal sender As Object, _
               ByVal e As mCore.NewUSSDReceivedEventArgs) _
               Handles objSMS.NewUSSDReceived

      MsgBox(e.Message & vbCrLf & vbCrLf & _
         "STATUS: " & e.Status.ToString, _
         MsgBoxStyle.Information, "NEW USSD RECEIVED")

   End Sub

   Public Sub SetCommParameters()
      Try
         objSMS.Port = "COM1"
         objSMS.BaudRate = mCore.BaudRate.BaudRate_19200
         objSMS.DataBits = mCore.DataBits.Eight
         objSMS.StopBits = mCore.StopBits.One
         objSMS.Parity = mCore.Parity.None
         objSMS.FlowControl = mCore.FlowControl.RTS_CTS

      Catch ex As mCore.GeneralException
         MsgBox(ex.Message)
      Catch ex As Exception
      End Try
   End Function
End Class

class MyClass
{
public mCore.SMS objSMS = new mCore.SMS();

public MyClass()

   {
      try
      {
         SetCommParameters();
         objSMS.NewUSSDIndication = true;
         objSMS.SendUSSD("*101#");
      }
      catch (mCore.GeneralException e)
      {
         MessageBox.Show(e.ToString());
      }

      objSMS.NewUSSDReceived +=
         new mCore.SMS.NewUSSDReceivedHandler(objSMS_NewUSSDReceived);
   }

   //New USSD Message Event Handling
   //A message box will pop-up whenever
   //a new USSD message is received
   private void objSMS_NewUSSDReceived
      (object sender, mCore.NewUSSDReceivedEventArgs e)
   {
      MessageBox.Show("NEW USSD RECEIVED" + "\r\n" +
         e.Message + "\r\n\r\n" +
         "STATUS: " + e.Status.ToString);
   }

   public static void SetCommParameters()
   {
      try
      {
         objSMS.Port = "COM1";
         objSMS.BaudRate = mCore.BaudRate.BaudRate_19200;
         objSMS.DataBits = mCore.DataBits.Eight;
         objSMS.StopBits = mCore.StopBits.One;
         objSMS.Parity = mCore.Parity.None;
         objSMS.FlowControl = mCore.FlowControl.RTS_CTS;
      }

      catch (mCore.GeneralException e)
      {
         MessageBox.Show(e.ToString());
      }
      catch (Exception e)
      {
      }
   }
}

mCore™ .NET SMS Library 1.2 mCore.SMS.CancelUSSDSession Method

Description:

Remarks:

Exceptions:

Usage Example:

See Also:

mCore™ .NET SMS Library 1.2

mCore.SMS.CancelUSSDSession Method