Topic Path: Symbol Reference > Classes > TIdNNTP Class > TIdNNTP Methods > GetHeader Method > GetHeader Method (string, TIdMessage)
TIdNNTP.GetHeader Method (string, TIdMessage)

Retrieves the headers for an NNTP article.

function GetHeader(
    AMsgID: string; 
    AMsg: TIdMessage
): Boolean; overload;
Message Identifier for the article.
TIdMessage where the article headers should be stored. 

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

GetHeader is an overloaded Boolean function in TIdNNTP used to retrieve message headers for an NNTP article. GetHeader calls SendCmd using the NNTP HEAD command to retrieve message headers. 

AMsgID is the Message Identifier for the NNTP article. 

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

When using GetHeader 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, GetHeader clears the contents of the message using TIdMessage.Clear and calls ReceiveHeader using AMsg as an argument. 

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


no newsgroup has been selected 
no current article has been selected 
no such article number in this group 
no such article found 


Use SelectGroup to select the active newsgroup before prior to calling GetHeader. 

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

Use XHDR to get specific header values for one or more NNTP articles. 

Use XOVER to get information from the overview database for one or more NNTP articles.

Copyright 1993-2006, Chad Z. Hower (aka Kudzu) and the Indy Pit Crew. All rights reserved.
Post feedback to the Indy Docs Newsgroup.