TIdNNTP.GetArticle Method (Integer, TIdMessage)

Retrieves a complete NNTP article.

Pascal

function GetArticle(
    AMsgNo: Integer; 
    AMsg: TIdMessage
): Boolean; overload;

Parameters

Parameters	Description
AMsgNo	Index number for the article.
AMsg	TIdMessage where the complete article should be stored.

Returns

Boolean - True if the article is successfully retrieved.

Description

GetArticle is an overloaded Boolean function in TIdNNTP used to retrieve a complete NNTP article including the headers and body.

GetArticle calls SendCmd to issue the NNTP ARTICLE command used to perform article retrieval using the message number in AMsgNo to store the NNTP article in the message instance specified in AMsg. AMsg is cleared prior to retrieval of the NNTP article.

The NNTP current article pointer is set to the indicated article.

GetArticle calls ReceiveHeader and ReceiveBody using AMsg as an argument.

The return value for GetArticle is True when the numeric response from SendCmd is 220. GetArticle will return False if any of the following responses are received:

Code	Message
412	no newsgroup has been selected
420	no current article has been selected
423	no such article number in this group
430	no such article found

Use SelectGroup to select the active newsgroup prior to calling GetArticle.

Use SelectArticle to set the current article pointer for the active newsgroup.

Use GetNewNewsList to get a list of articles added since a specified date and time.

Use GetHeader to retrieve the headers for a specific NNTP article. Use GetBody to retrieve the body text for a specific NNTP article.