IMsgStore::SetReceiveFolder
Область применения: Outlook 2013 | Outlook 2016
Устанавливает папку в качестве назначения для входящих сообщений определенного класса сообщений.
HRESULT SetReceiveFolder(
LPSTR lpszMessageClass,
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Параметры
lpszMessageClass
[в] Указатель на класс сообщения, который должен быть связан с новой папкой получения. Если для параметра lpszMessageClass задано значение NULL или пустая строка, SetReceiveFolder задает папку получения по умолчанию для хранилища сообщений.
ulFlags
[в] Битовая маска флагов, управляющая типом текста в передаваемых строках. Можно задать следующий флаг:
MAPI_UNICODE
Строка класса сообщения имеет формат Юникода. Если флаг MAPI_UNICODE не задан, строка класса сообщения имеет формат ANSI.
cbEntryID
[в] Число байтов в идентификаторе записи, на который указывает параметр lpEntryID .
lpEntryID
[в] Указатель на идентификатор записи папки, которую необходимо установить в качестве папки получения. Если параметр lpEntryID имеет значение NULL, setReceiveFolder заменяет текущую папку получения на значение по умолчанию хранилища сообщений.
Возвращаемое значение
S_OK
Папка получения успешно установлена.
Замечания
Метод IMsgStore::SetReceiveFolder задает или изменяет папку получения для определенного класса сообщений. С помощью SetReceiveFolder клиент может, используя последовательные вызовы, указать другую папку получения для каждого определенного класса сообщения или указать, что входящие сообщения для нескольких классов сообщений отправляются в одну папку. Например, клиент может иметь собственный класс сообщений, поступающих в собственную папку. Приложение факса может указать одну папку, в которую поставщик хранилища помещает входящие факсы, и другую папку, в которую поставщик помещает исходящие факсы.
Если во время вызова SetReceiveFolder возникает ошибка, параметр папки получения остается без изменений.
Если setReceiveFolder изменяет параметр папки получения с параметром lpEntryID , равным NULL, указывая, что должна быть задана папка получения по умолчанию, SetReceiveFolder возвращает S_OK, даже если для указанного класса сообщений не было существующего параметра.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnSetReceiveFolder |
MFCMAPI использует метод IMsgStore::SetReceiveFolder , чтобы задать папку в качестве папки получения для определенного класса сообщений. |