TIdNNTP.GetBody Method (string, TIdMessage)

Retrieves the body for an NNTP article.

Pascal

function GetBody(
    AMsgID: string; 
    AMsg: TIdMessage
): Boolean; overload;

Parameters

Parameters	Description
AMsgID	Message Identifier for the article.
AMsg	TIdMessage where the article should be stored.

Returns

Boolean - True on success, False on protocol or server error.

Description

GetBody is an overloaded Boolean function in TIdNNTP used to retrieve the message body for a NNTP article. GetBody calls SendCmd using the NNTP BODY command to retrieve body lines.

AMsgID is the Message Identifier for the NNTP article.

AMsg is a TIdMessage instance where the body for the NNTP article should be stored.

When using GetBody with a message identifier string, the NNTP current article pointer is NOT set to the indicated article.

When a TIdMessage instance is used as the destination, GetBody clears the contents of the message using TIdMessage.Clear and calls ReceiveBody using AMsg as an argument.

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

Code	Meaning
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 before calling GetBody.

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 GetArticle to retrieve the entire contents of a specific NNTP article.