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 方法获取要显示的接收文件夹表。

另请参阅

IMAPITable::QueryColumns

IMAPITable::QueryRows

IMAPITable::QuerySortOrder

IMAPITable::SetColumns

IMsgStore : IMAPIProp

MFCMAPI 代码示例