ListArticles Method  
 

Return a list of articles in the current newsgroup.

Syntax

object.ListArticles( [FirstArticle], [LastArticle] )

Parameters

FirstArticle
An optional integer argument which specifies the first article to list. If this argument is omitted, the list will start with the first available article in the newsgroup.
LastArticle
An optional integer argument which specifies the last article to list. If this argument is omitted, the list will end with the last available article in the newsgroup.

Return Value

A value of zero is returned if the operation was successful, otherwise a non-zero error code is returned which indicates the cause of the failure.

Remarks

The ListArticles method requests that the server return a list of news articles in the specified range for the current newsgroup. The OnNewsArticle event will be fired for each article returned by the server. When the last news article has been listed, the OnLastArticle event will be fired.

While the articles in the newsgroup are being listed, the client cannot retrieve the contents of a specific article. For example, the GetArticle method cannot be called while inside the OnNewsArticle event. The client should store those articles which it wants to retrieve in an array, and then once all of the articles have been listed, it can begin calling GetArticle for each article number to retrieve the article text.

A program should use either the ListArticles method or the GetFirstArticle and GetNextArticle methods, but never in combination with one another.

See Also

FirstArticle Property, LastArticle Property, GetFirstArticle Method, GetNextArticle Method, SelectGroup Method, OnLastArticle Event, OnNewsArticle Event