IMAPITable::QueryColumns

适用于:Outlook 2013 | Outlook 2016

返回表的列列表。

HRESULT QueryColumns(
ULONG ulFlags,
LPSPropTagArray FAR * lpPropTagArray
);

参数

ulFlags

[in]指示应返回哪个列集的标志的位掩码。 可以设置以下标志:

TBL_ALL_COLUMNS

该表应返回所有可用列。

lpPropTagArray

[out]指向包含列集的属性标记的 SPropTagArray 结构的指针。

返回值

S_OK

已成功返回列集。

MAPI_E_BUSY

另一个操作正在进行中,该操作阻止启动列集检索操作。 应允许正在进行的操作完成,或者应停止该操作。

备注

可以调用 IMAPITable::QueryColumns 方法来检索:

  • 表的默认列集。

  • 表的当前列集,通过调用 IMAPITable::SetColumns 方法建立。

  • 表的完整列集,即可用的列,但不一定是当前集的一部分。

给调用方的说明

如果未设置TBL_ALL_COLUMNS标志, IMAPITable::QueryColumns 将返回表的默认列集或当前列集,具体取决于该表是否受 IMAPITable::SetColumns 调用的影响。 SetColumns 更改表列集中列的顺序和选择。

如果设置TBL_ALL_COLUMNS标志, QueryColumns 将返回能够在表的列集中的所有列。

通过调用 MAPIFreeBuffer 函数释放 lpPropTagArray 参数指向的属性标记数组的内存。

MFCMAPI 引用

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

文件 函数 Comment
ContentsTableListCtrl.cpp
CContentsTableListCtrl::D oSetColumns
MFCMAPI 使用 IMAPITable::QueryColumns 方法检索表的当前列集,以便用户可以对其进行编辑。

另请参阅

IMAPITable::SetColumns

MAPIFreeBuffer

SPropTagArray

IMAPITable : IUnknown

MFCMAPI 代码示例