IAddrBook::SetSearchPath

Gilt für: Outlook 2013 | Outlook 2016

Legt einen neuen Suchpfad im Profil fest, der für den Namensauflösungsprozess verwendet wird.

HRESULT SetSearchPath(
  ULONG ulFlags,
  LPSRowSet lpSearchPath
);

Parameter

ulFlags

[in] Reserviert. NULL muss sein.

lpSearchPath

[in] Ein Zeiger auf die SRowSet-Struktur , die zum Speichern des Suchpfads verwendet wird. Die erste Eigenschaft für jedes aRow-Element in SRowSet muss PR_ENTRYID (PidTagEntryId) sein.

Rückgabewert

S_OK

Der Suchpfad wurde erfolgreich festgelegt.

MAPI_E_MISSING_REQUIRED_COLUMN

Einer der in der SRowSet-Struktur beschriebenen Container enthielt seine PR_ENTRYID-Eigenschaft nicht.

Hinweise

Clients und Dienstanbieter rufen die SetSearchPath-Methode auf, um Änderungen zu speichern, die an der Containersuchreihenfolge vorgenommen wurden, die zum Auflösen von Namen mit der IAddrBook::ResolveName-Methode verwendet wird. Der Suchpfad wird zwischen Instanzen einer Sitzung gespeichert.

Clients und Anbieter müssen die IMAPIProp::SaveChanges-Methode nicht aufrufen, um die Änderungen des Suchpfads dauerhaft zu machen.

Siehe auch

IAddrBook::GetDefaultDir

IAddrBook::GetPAB

IAddrBook::GetSearchPath

PidTagContainerFlags (kanonische Eigenschaft)

IAddrBook : IMAPIProp