IMAPITable::GetStatus
适用于:Outlook 2013 | Outlook 2016
返回表的状态和类型。
HRESULT GetStatus(
ULONG FAR * lpulTableStatus,
ULONG FAR * lpulTableType
);
参数
lpulTableStatus
[out]指向指示表状态的值的指针。 可以返回以下值之一:
TBLSTAT_COMPLETE
未执行任何操作。
TBLSTAT_QCHANGED
表的内容已预期发生更改。 对于排序或限制操作导致的更改,不会返回此状态值。
TBLSTAT_RESTRICT_ERROR
IMAPITable::Restrict 操作期间出错。
TBLSTAT_RESTRICTING
IMAPITable::Restrict 操作正在进行中。
TBLSTAT_SETCOL_ERROR
在 IMAPITable::SetColumns 操作期间发生错误。
TBLSTAT_SETTING_COLS
IMAPITable::SetColumns 操作正在进行中。
TBLSTAT_SORT_ERROR
在 IMAPITable::SortTable 操作期间发生错误。
TBLSTAT_SORTING
IMAPITable::SortTable 操作正在进行中。
lpulTableType
[out]指向指示表类型的值的指针。 可以返回以下三种表类型之一:
TBLTYPE_DYNAMIC
表的内容是动态的;行和列值可能会随着基础数据的更改而更改。
TBLTYPE_KEYSET
表中的行是固定的,但这些行中的列的值是动态的,并且可能会随着基础数据的更改而更改。
TBLTYPE_SNAPSHOT
表是静态的,其内容在基础数据更改时不会更改。
返回值
S_OK
已成功返回表的状态。
备注
IMAPTable::GetStatus 方法检索有关表类型和当前状态的信息。
给调用方的说明
可以将 GetStatus 与其他三种 IMAPITable 方法结合使用,以监视这些操作的状态并确定对表的影响。 执行以下 IMAPITable 调用之一后调用 GetStatus:
IMAPITable::Restrict 以设置限制。
用于建立排序顺序的 IMAPITable::SortTable。
用于定义列集的 IMAPITable::SetColumns。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
ContentsTableListCtrl.cpp |
CContentsTableListCtrl::GetStatus |
MFCMAPI 使用 IMAPITable::GetStatus 方法报告表的状态。 |