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 範例程式代碼，請參閱下表。
| 檔案 | Function | Comment |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl：：GetStatus |
MFCMAPI 使用 IMAPITable：：GetStatus 方法來報告數據表的狀態。 |