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 方法检索表的当前列集,以便用户可以对其进行编辑。 |