IMAPISession::GetStatusTable
适用于:Outlook 2013 | Outlook 2016
提供对状态表的访问权限,该表包含有关会话中所有 MAPI 资源的信息。
HRESULT GetStatusTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
参数
ulFlags
[in]标志的位掩码,用于确定字符串列的格式。 可以设置以下标志:
MAPI_UNICODE
字符串列采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则字符串列采用 ANSI 格式。
lppTable
[out]指向状态表的指针的指针。
返回值
S_OK
已成功返回表。
备注
IMAPISession::GetStatusTable 方法提供对包含会话中所有 MAPI 资源的信息的状态表的访问权限。 表中有一行用于介绍 MAPI 子系统的信息,一行用于 MAPI 后台处理程序,一行用于集成通讯簿,一行用于配置文件中的每个服务提供程序。
有关状态表中必需列和可选列的完整列表,请参阅 状态表。
在 ulFlags 参数中设置MAPI_UNICODE标志会影响从 IMAPITable::QueryColumns 和 IMAPITable::QueryRows 方法返回的列的格式。 此标志还控制 IMAPITable::QuerySortOrder 方法返回的排序顺序中的属性类型。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
MainDlg.cpp |
CMainDlg::OnStatusTable |
MFCMAPI 使用 IMAPISession::GetStatusTable 方法获取要呈现的状态表。 |