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.