IMsgStore::SetReceiveFolder
适用于:Outlook 2013 | Outlook 2016
将文件夹建立为特定邮件类的传入邮件的目标。
HRESULT SetReceiveFolder(
LPSTR lpszMessageClass,
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
参数
lpszMessageClass
[in]指向要与新接收文件夹关联的邮件类的指针。 如果 lpszMessageClass 参数设置为 NULL 或空字符串, SetReceiveFolder 将设置邮件存储的默认接收文件夹。
ulFlags
[in]控制传入字符串中文本类型的标志的位掩码。 可以设置以下标志:
MAPI_UNICODE
消息类字符串采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则消息类字符串采用 ANSI 格式。
cbEntryID
[in] lpEntryID 参数指向的条目标识符中的字节计数。
lpEntryID
[in]指向要建立为接收文件夹的文件夹的条目标识符的指针。 如果 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 方法将文件夹设置为特定邮件类的接收文件夹。 |