IAddrBook::SetSearchPath

The IAddrBook::SetSearchPath method sets a new search path in the profile that is used for the name resolution process.

Quick Info

See IAddrBook : IMAPIProp.

HRESULT SetSearchPath(
  ULONG ulFlags,          
  LPSRowSet lpSearchPath  
);

Parameters

ulFlags: Reserved; must be zero.
lpSearchPath: [in] Pointer to the SRowSet structure used to hold the search path. The first property for each aRow member in the SRowSet must be PR_ENTRYID.

Return Values

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 IAddrBook::SetSearchPath method to save changes made to the container search order that is used to resolve names with IAddrBook::ResolveName. The search path is saved between instances of a session. This functionality means that, after a call to the IMAPISession::Logoff method, subsequent calls to the MAPILogonEx function during the same session return the same search path as previously set, as long as that search path still exists.

Clients and providers need not call the IMAPIProp::SaveChanges method to make the search path changes permanent.