IAddrBook::SetSearchPath

适用于:Outlook 2013 | Outlook 2016

在配置文件中设置用于名称解析过程的新搜索路径。

HRESULT SetSearchPath(
  ULONG ulFlags,
  LPSRowSet lpSearchPath
);

参数

ulFlags

[in]保留;必须为零。

lpSearchPath

[in]指向用于保存搜索路径的 SRowSet 结构的指针。 SRowSet 中每个Row 成员的第一个属性必须PR_ENTRYID (PidTagEntryId) 。

返回值

S_OK

已成功设置搜索路径。

MAPI_E_MISSING_REQUIRED_COLUMN

SRowSet 结构中描述的容器之一不包括其 PR_ENTRYID 属性。

备注

客户端和服务提供商调用 SetSearchPath 方法以保存对容器搜索顺序所做的更改,这些更改用于使用 IAddrBook::ResolveName 方法解析名称。 搜索路径在会话的实例之间保存。

客户端和提供程序不必调用 IMAPIProp::SaveChanges 方法,以使搜索路径更改永久。

另请参阅

IAddrBook::GetDefaultDir

IAddrBook::GetPAB

IAddrBook::GetSearchPath

PidTagContainerFlags 规范属性

IAddrBook : IMAPIProp