Returned log event information

The ReturnValue property returned by a synchronous GetList call and by callback for an asynchronous GelList call is an iterator containing information about the requested entries in the event log. Each item (object) in the iterator corresponds to one entry in the event log.

Table: ReturnValue properties for entries in the event log

Property

Description

Value type

Type

<item>.EventType

Contains a unique identifier for the type of entry.

Possible values:

0 - EKLogCallEventType

1 - EKLogDataEventType

2 - EKLogFaxEventType

3 - EKLogShortMessageEventType

4 - EKLogPacketDataEventType

number

<item>.RemoteParty

Contains the destination of the outgoing event or the source of incoming event.

Up to 64 characters. If the length of the specified string is greater than 64 characters, the data is truncated.

string

<item>.Direction

Contains whether the event is incoming, outgoing, or missed and if it came in on an alternate line.

Alternate line refers to the second phone call on the mobile device. Alternate line values, such as 2 - EIncomingEventAlternateline, are valid for call events only.

Possible values:

0 - EIncomingEvent

1 - EOutgoingEvent

2 - EIncomingEventAlternateline

3 - EOutgoingEventAlternateline

4 - EFetchedEvent

5 - EMissedEvent

6 - EMissedEventAlternateline

number

<item>.EventTime

Contains the time at which the event was created. The mobile device automatically sets this time.

 

string

<item>.EventDuration

Contains the duration of the event, in seconds.

 

number

<item>.DeliveryStatus

Contains whether the event was delivered, is pending, failed to be delivered, and so on.

Possible Values:

0 - EStatusPending

1 - EStatusSent

2 - EStatusFailed

3 - EStatusNone

4 - EStatusDone

5 - EStatusSent

6 - EStatusScheduled

number

<item>.Subject

Contains the subject for the event.

 

string

<item>.PhoneNumber

Contains the phone number associated with the event.

 

string

<item>.Description

Contains information about the type of event, such as voice call or short message. The mobile device automatically defines this description.

 

string

<item>.Link

Contains an ID that links the log event to an entity in another application. For example, the log event can be associated with a call ID or message ID for emails and faxes.

 

number

<item>.id

Contains a unique identifier of the event in the log database.

 

string

<item>.LogFlags

Contains the flags for this event.

Possible values:

0 - EKLogEventContactSearched

Note: The EKLogEventContactSearched flag is set when the user searches the contact database for any operation such as a voice call or SMS.

1 - EKLogEventRead

Note: The EKLogEventRead flag is set when the user "reads" the event in the log database.

number