diff -r 913c9751c067 -r 716254ccbcc0 org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-7E53CD9F-E213-42E7-8569-02AEA1198E52.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-7E53CD9F-E213-42E7-8569-02AEA1198E52.html Fri Mar 05 19:11:15 2010 -0800 @@ -0,0 +1,157 @@ + + +
Description:
+The GetList
method retrieves an iterable list of
+entries from the log event database. The database contains two types of entries,
+log entries (all entries) and recent log entries (a subset of all log entries).
This method can be called both synchronously and asynchronously.
+Syntax:
+For synchronous calls:
+result = so.IDataSource.GetList(criteria);+ +
For asynchronous calls:
+result = so.IDataSource.GetList(criteria, callback);+ +
Arguments:
+criteria
:
This is an object that specifies what information is returned from the +log event database. For more information about the object properties and how +to define them, see section Criteria for retrieving log events.
+ +callback
:
The callback
argument is the name of the method
+that is executed when an asynchronous GetList
call has
+results or status information to return. You must define this method separately.
+Follow the instructions in section Defining the callback handler for an asynchronous method to
+define the callback
method.
This argument is used only with an asynchronous GetList
call.
Return value:
+If synchronous, the GetList
method returns an object
+that contains the requested log event information, an error code, and an error
+message.
+ Property + |
+ Description + |
+ Value + |
---|---|---|
+
|
+
+ This is an iterator that contains the requested log event information. + |
++ + | +
+
|
+
+ This is a number that specifies a predefined error code. + |
+
+ See Service API error codes . + |
+
+
|
+
+ This is a text string that describes the error. + |
++ + | +
If asynchronous, the GetList
method returns an
+object that contains the initial return value from the asynchronous call that
+it started (see the following table). The actual information is returned by
+the callback
method
+in the ReturnValue
property of its result object. The
+returned information is described in section Returned log event information.
+ Property + |
+ Description + |
+ Value + |
---|---|---|
+
|
+
+ This is a number used as an identification to match transactions started
+with the asynchronous This property is only valid for asynchronous calls. + |
++ |
+
|
+
+ This is a number that specifies a predefined error code. + |
++ + | +
+
|
+
+ This is a text string that describes the error. + |
++ + | +
Remarks:
+To access information about individual log events, 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.
+ + + + +