IAddrBook::SetSearchPath
適用於:Outlook 2013 |Outlook 2016
設定設定檔中用於名稱解析程式的新搜尋路徑。
HRESULT SetSearchPath(
ULONG ulFlags,
LPSRowSet lpSearchPath
);
參數
ulFlags
[in]保留;必須是零。
lpSearchPath
[in]用來保存搜尋路徑 之 SRowSet 結構的指標。 SRowSet 中每個 aRow 成員的第一個屬性必須PR_ENTRYID (PidTagEntryId) 。
傳回值
S_OK
搜尋路徑已成功設定。
MAPI_E_MISSING_REQUIRED_COLUMN
SRowSet 結構中所述的其中一個容器未包含其PR_ENTRYID屬性。
註解
用戶端和服務提供者會呼叫 SetSearchPath 方法,以儲存對容器搜尋順序所做的變更,此變更是用來使用 IAddrBook::ResolveName 方法解析名稱。 搜尋路徑會儲存在工作階段的實例之間。
用戶端和提供者不需要呼叫 IMAPIProp::SaveChanges 方法,即可永久變更搜尋路徑。