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 方法返回的排序顺序中的属性类型。

给调用方的说明

如果你已注册接收此一次性表的更改通知,你还将收到其他提供程序的一次性表的更改通知。 根据这些通知,可以支持在当前会话期间添加的新地址类型。

另请参阅

IABContainer::CreateEntry

IMAPISupport::NewEntry

IMAPITable : IUnknown

IMAPITable::QueryColumns

IMAPITable::QueryRows

IMAPITable::QuerySortOrder

PidTagCreateTemplates 规范属性

IMAPISupport : IUnknown

一次性表