Published: July 16, 2012
Establishes a folder as the destination for incoming messages of a particular message class.
The IMsgStore::SetReceiveFolder method sets or changes the receive folder for a particular message class. With SetReceiveFolder, a client can, by using successive calls, specify a different receive folder for each defined message class or specify that incoming messages for multiple message classes all go to the same folder. For example, a client can have its own class of messages arrive in its own folder. A fax application can designate one folder in which the store provider puts incoming faxes and another folder in which the provider puts outgoing faxes.
If an error occurs during the call to SetReceiveFolder, the receive folder setting remains unchanged.
If SetReceiveFolder changes the receive folder setting with lpEntryID set to NULL, indicating that the default receive folder should be set, SetReceiveFolder returns S_OK even if there was no existing setting for the indicated message class.