# IMessaging.GetList()

Description:

The `GetList` method retrieves a list of messaging objects from the Messaging Center of the S60 device. Each object contains messaging information, that is, header and content data for a single message.

This is a synchronous method.

Syntax:

    result = so.IMessaging.GetList(criteria);

Arguments:

- `criteria`:

  This is an object that specifies what messaging information is returned and how the returned information is sorted. For more information about the object properties and how to define them, see section Criteria for retrieving messaging information.

Return value:

The `GetList` method returns an object that contains the requested messaging information, an error code, and an error message.

Table: Return value properties for GetList
Property | Description | Value
--- | --- | ---
`result.ReturnValue` | This is an iterator that contains the requested messaging information. | See Returned messaging information.
`result.ErrorCode` | This is a number that specifies a predefined error code. | See Service API error codes.
`result.ErrorMessage` | This is a text string that describes the error. | See Messaging Service API error messages.

Remarks:

To access information about individual messages, iterate through the list of objects contained in `result.ReturnValue`.

Example code:

For the complete source of a sample widget that demonstrates how to use this Service API, see the full example.