Compartilhar via


IAddrBook::SetSearchPath

Aplica-se a: Outlook 2013 | Outlook 2016

Define um novo caminho de pesquisa no perfil usado para o processo de resolução de nomes.

HRESULT SetSearchPath(
  ULONG ulFlags,
  LPSRowSet lpSearchPath
);

Parâmetros

ulFlags

[in] Reservados; deve ser zero.

lpSearchPath

[in] Um ponteiro para a estrutura SRowSet usada para manter o caminho de pesquisa. A primeira propriedade para cada membro aRow no SRowSet deve ser PR_ENTRYID (PidTagEntryId).

Valor de retorno

S_OK

O caminho de pesquisa foi definido com êxito.

MAPI_E_MISSING_REQUIRED_COLUMN

Um dos contêineres descritos na estrutura SRowSet não incluiu sua propriedade PR_ENTRYID .

Comentários

Clientes e provedores de serviços chamam o método SetSearchPath para salvar alterações feitas na ordem de pesquisa de contêiner usada para resolve nomes com o método IAddrBook::ResolveName. O caminho de pesquisa é salvo entre instâncias de uma sessão.

Clientes e provedores não precisam chamar o método IMAPIProp::SaveChanges para tornar as alterações de caminho de pesquisa permanentes.

Confira também

IAddrBook::GetDefaultDir

IAddrBook::GetPAB

IAddrBook::GetSearchPath

Propriedade Canônica PidTagContainerFlags

IAddrBook : IMAPIProp