IMAPISupport::GetOneOffTable
适用于:Outlook 2013 | Outlook 2016
返回指向 MAPI 一次性表的指针, (所有通讯簿提供商都支持) 创建新收件人的模板列表。
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
参数
ulFlags
[in]控制字符串列类型的标志的位掩码。 可以设置以下标志:
MAPI_UNICODE
字符串列采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则字符串列采用 ANSI 格式。
lppTable
[out]指向一次性表的指针的指针。
返回值
S_OK
已成功检索一次性表。
备注
IMAPISupport::GetOneOffTable 方法为通讯簿提供程序支持对象实现。 通讯簿提供程序调用 GetOneOffTable 以检索用于创建新收件人的模板的完整列表。 此表包括会话中处于活动状态的通讯簿提供程序支持的模板,以及 MAPI 支持的模板。
新创建的收件人可用于对邮件进行寻址,也可以添加到通讯簿容器中。
有关构成一次性表中所需列集的属性列表,请参阅 一次性表。
在 ulFlags 参数中设置MAPI_UNICODE标志会影响从 IMAPITable::QueryColumns 和 IMAPITable::QueryRows 方法返回的列的格式。 此标志还控制 IMAPITable::QuerySortOrder 方法返回的排序顺序中的属性类型。
给调用方的说明
如果你已注册接收此一次性表的更改通知,你还将收到其他提供程序的一次性表的更改通知。 根据这些通知,可以支持在当前会话期间添加的新地址类型。