The NntpPostArticle function is used to post the contents
of the specified buffer to the server as a new article in the
current newsgroup. Not all newsgroups permit new articles to be
posted, and some newsgroups may require that you email the article
to a moderator for approval instead of posting directly to the
group. It may be required that the client authenticate itself using
the NntpAuthenticate function prior to posting the
article.
A news article is similar to an email message in that it
contains one or more header fields, followed by an empty line,
followed by the body of the article. Each line of text should be
terminated by a carriage return/linefeed sequence of characters.
The Mail Message library can be used to compose a message if
needed. Note that the article header must contain a header field
named "Newsgroups" with a value that specifies the newsgroup or
newsgroups the article is being posted to. If this header field is
missing, the news server will reject the article.
This function will cause the current thread to block until the
transfer has completed, a timeout occurs or the transfer is
canceled. During the transfer, the HTTP_EVENT_PROGRESS event will
be periodically fired, enabling the application to update any user
interface controls. Event notification must be enabled, either by
calling NntpEnableEvents, or by registering a callback
function using the NntpRegisterEvent function.
To determine the current status of a transfer while it is in
progress, use the NntpGetTransferStatus function.