MessageIn Event

This event is fired upon receipt of a message.

Syntax

public event OnMessageInHandler OnMessageIn;

public delegate void OnMessageInHandler(object sender, SmppMessageInEventArgs e);

public class SmppMessageInEventArgs : EventArgs {
  public string SourceAddress { get; }
  public string ScheduleDeliveryTime { get; }
  public string ValidityPeriod { get; }
  public string Message { get; }
  public int MessagePart { get; }
  public int MessagePartCount { get; }
  public int MessagePartReference { get; }
  public string DestinationAddress { get; }
  public int ResponseErrorCode { get; set; }
}
Public Event OnMessageIn As OnMessageInHandler

Public Delegate Sub OnMessageInHandler(sender As Object, e As SmppMessageInEventArgs)

Public Class SmppMessageInEventArgs Inherits EventArgs
  Public ReadOnly Property SourceAddress As String
  Public ReadOnly Property ScheduleDeliveryTime As String
  Public ReadOnly Property ValidityPeriod As String
  Public ReadOnly Property Message As String
  Public ReadOnly Property MessagePart As Integer
  Public ReadOnly Property MessagePartCount As Integer
  Public ReadOnly Property MessagePartReference As Integer
  Public ReadOnly Property DestinationAddress As String
  Public Property ResponseErrorCode As Integer
End Class

Remarks

When a message is received, the SMPP component will parse the sender's message into the SourceAddress, ScheduleDeliveryTime, ValidityPeriod, and Message fields.

The SourceAddress parameter is the address of the originator of the message.

The DestinationAddress parameter holds the address of the recipient.

The ScheduleDeliveryTime parameter is the delivery time which the short message is scheduled to be forwarded to another MC. This will be an empty string if not scheduled.

The ValidityPeriod parameter is only applicable if this short message is being forwarded to another MC. When this occurs, it specifies how long the receiving MC should retain the SM and continue trying to deliver it. This will be an empty string if the current validity period is unavailable.

The Message parameter is the plaintext portion of the message body.

If the incoming message is a part of a larger message (the message was split up into several parts), the MessagePartCount, MessagePart, and MessagePartReference parameters will be set. MessagePartCount will hold the total number of parts for the message. MessagePart will indicate the current part's location in the message to determine the order when re-assembling the message. This will be a value from 1 to MessagePartCount. MessagePartReference holds a reference value that will be the same across all parts for the message.

The ResponseErrorCode parameter may be set to return an error condition to the server. This corresponds to the command_status protocol level field of the response.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks 2020 .NET Edition - Version 20.0 [Build 8307]