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

MFCMAPI 引用

有关 MFCMAPI 示例代码,请参阅下表。

文件 函数 Comment
ContentsTableListCtrl.cpp
CContentsTableListCtrl::GetStatus
MFCMAPI 使用 IMAPITable::GetStatus 方法报告表的状态。

另请参阅

IMAPITable::Restrict

IMAPITable::SetColumns

IMAPITable::SortTable

IMAPITable : IUnknown

MFCMAPI 代码示例