IABLogon::GetOneOffTable

适用于:Outlook 2013 | Outlook 2016

返回一个一次性模板表,用于创建要添加到传出邮件收件人列表中的收件人。

HRESULT GetOneOffTable(
  ULONG ulFlags,
  LPMAPITABLE FAR * lppTable
);

参数

ulFlags

[in]控制表中包含的字符串列类型的标志的位掩码。 可以设置以下标志:

MAPI_UNICODE

字符串列采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则字符串列采用 ANSI 格式。

lppTable

[out]指向一次性表的指针的指针。

返回值

S_OK

已成功检索一次性表。

MAPI_E_BAD_CHARWIDTH

MAPI_UNICODE标志已设置,通讯簿提供程序不支持 Unicode,或者未设置MAPI_UNICODE,并且通讯簿提供程序仅支持 Unicode。

MAPI_E_NO_SUPPORT

通讯簿提供程序不提供任何一次性模板。

备注

MAPI 调用 GetOneOffTable 方法,以便提供可用于创建收件人的一次性模板。 新收件人将添加到传出邮件的收件人列表中。 通讯簿提供商应支持一次性表上的通知,以通知 MAPI 模板修改。 MAPI 使一次性表保持打开状态,以启用动态更新。

通讯簿提供程序还可以为每个容器支持一次性表。 调用方通过调用容器的 IMAPIProp::OpenProperty 方法并请求 (PidTagCreateTemplates) 属性PR_CREATE_TEMPLATES来检索此一次性表。 此表提供的模板用于将收件人添加到容器。 有关这两种类型的一次性表之间的差异的讨论,请参阅 实现 One-Off 表

有关通讯簿提供程序的一次性表中所需列的列表,请参阅 一次性表

另请参阅

IABContainer::CreateEntry

IAddrBook::NewEntry

IMAPISupport::GetOneOffTable

IABLogon : IUnknown