| |
| INT WINAPI NntpListArticles(
|
| |
HCLIENT hClient, |
|
| |
LONG nFirstArticle, |
|
| |
LONG nLastArticle |
|
| );
|
The NntpListArticles function returns a list of articles
in the currently selected newsgroup, within the specified article
range.
Parameters
- hClient
- Handle to the client session.
- nFirstArticle
- The first newsgroup article to be returned in the list. If this
value is -1, the list will begin with the first available article
in the newsgroup.
- nLastArticle
- The last newsgroup article to be returned in the list. If the
value is -1, the list will end with the last available article in
the newsgroup.
Return Value
If the function succeeds, the return value is the server result
code. If the function fails, the return value is NNTP_ERROR. To get
extended error information, call NntpGetLastError.
Remarks
It is possible that there will be gaps in the articles within
the range of the first and last articles in the newsgroup. This may
be due to a message being canceled or expired. Use the
NntpGetFirstArticle and NntpGetNextArticle functions
to read the list of articles returned by the server.
Example
NEWSARTICLE newsArticle;
BOOL bResult;
INT nResult;
// List all articles in the current group
nResult = NntpListArticles(hClient, -1L, -1L);
if (nResult == NNTP_ERROR)
{
TCHAR szError[ASTRING];
DWORD dwError = NntpGetLastError();
NntpGetErrorString(dwError, szError, ASTRING);
fprintf(stderr, "Error %08x: %s\n", dwError, szError);
return;
}
// Get each article in the current newsgroup, printing the article
// number and the subject of the article
bResult = NntpGetNextArticle(hClient, &newsArticle);
while (bResult)
{
printf("%ld %s %s\n", newsArticle.nArticleId, newsArticle.szSubject);
bResult = NntpGetNextArticle(hClient, &newsArticle);
}
Requirements
Client: Requires Windows 7, Windows Vista or Windows
XP.
Server: Requires Windows Server 2008 or Windows Server
2003.
Header: Include cstools7.h.
Library: Use csnwsav7.lib.
Unicode: Implemented as Unicode and ANSI versions.
See Also
NntpGetArticleRange,
NntpGetCurrentArticle,
NntpGetFirstArticle,
NntpGetNextArticle, NntpListGroups, NntpListNewGroups
|
|