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 方法,以使搜索路径更改永久。