IAddrBook::SetSearchPath
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Sets a new search path in the profile that is used for the name resolution process.
HRESULT SetSearchPath(
ULONG ulFlags,
LPSRowSet lpSearchPath
);
Parameters
ulFlags
[in] Reserved; must be zero.lpSearchPath
[in] A pointer to the SRowSet structure used to hold the search path. The first property for each aRow member in SRowSet must be PR_ENTRYID (PidTagEntryId).
Return Value
S_OK
The search path was successfully set.MAPI_E_MISSING_REQUIRED_COLUMN
One of the containers described in the SRowSet structure did not include its PR_ENTRYID property.
Remarks
Clients and service providers call the SetSearchPath method to save changes that were made to the container search order that is used to resolve names with the IAddrBook::ResolveName method. The search path is saved between instances of a session.
Clients and providers do not have to call the IMAPIProp::SaveChanges method to make the search path changes permanent.