IMsgStore::GetReceiveFolderTable
适用于:Outlook 2013 | Outlook 2016
提供对接收文件夹表的访问权限,该表包含有关邮件存储区的所有接收文件夹的信息。
HRESULT GetReceiveFolderTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable );
参数
ulFlags
[in]控制表访问的标志的位掩码。 可以设置以下标志:
MAPI_DEFERRED_ERRORS
允许 GetReceiveFolderTable 成功返回,可能是在表对调用方完全可用之前。 如果表未完全可用,则进行后续表调用可能会引发错误。
MAPI_UNICODE
返回的字符串采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则字符串采用 ANSI 格式。
lppTable
[out]指向接收文件夹表的指针的指针。
返回值
S_OK
已成功返回接收文件夹表。
备注
IMsgStore::GetReceiveFolderTable 方法提供对表的访问权限,该表显示所有邮件存储区接收文件夹的属性设置。
针对实现者的说明
有关接收文件夹表中必需列的列表,请参阅 接收文件夹表。
实现接收文件夹表以支持对 PR_RECORD_KEY (PidTagRecordKey) 属性设置属性限制。 这样可以轻松访问特定的接收文件夹。
给调用方的说明
在 ulFlags 参数中设置MAPI_UNICODE标志会影响从 IMAPITable::QueryColumns 和 IMAPITable::QueryRows 方法返回的列的格式。 此标志还控制 IMAPITable::QuerySortOrder 方法返回的排序顺序中的属性类型。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
MsgStoreDlg.cpp |
CMsgStoreDlg::OnDisplayReceiveFolderTable |
MFCMAPI 使用 IMsgStore::GetReceiveFolderTable 方法获取要显示的接收文件夹表。 |