Platform SDK: CDO for Windows 2000

Newsgroups Property

The Newsgroups property is the list the newsgroup recipients of the message.

[Visual Basic]
Property Newsgroups as String
[C++]
HRESULT get_Newsgroups(BSTR* pVal);
HRESULT put_Newsgroups(BSTR Val);
[IDL]
HRESULT [propget] Newsgroups([out,retval] BSTR* pVal);
HRESULT [propput] Newsgroups([in] BSTR Val);

Remarks

This property is also available as the urn:schemas:mailheader:newsgroups field.

The string in the Newsgroups property can represent a single newsgroup or multiple newsgroups. A newsgroup name is a set of words concatenated by periods, as shown in the following example:

name.public.discussion

In a list of multiple newsgroups, commas separate the names of the newsgroups, as follows:

alt.sample,sample.newsgroup.name,name.public.chat

A newsgroup name cannot contain a comma, and only existing newsgroups should be specified. If a newsgroup with a particular name does not exist, posting to that name does not cause the newsgroup to be created.

The Newsgroups property is required on news messages. If you do not set the Newsgroups property before calling the IMessage.Post method, an error is returned.

Responses to this message are posted to the same newsgroups unless the IMessage.FollowUpTo property is set.

The default value of the Newsgroups property is an empty string.