IAddrBook::GetSearchPath
Gilt für: Outlook 2013 | Outlook 2016
Gibt eine sortierte Liste von Eintragsbezeichnern der Container zurück, die in den von der IAddrBook::ResolveName-Methode initiierten Namensauflösungsprozess einbezogen werden sollen.
HRESULT GetSearchPath(
ULONG ulFlags,
LPSRowSet FAR * lppSearchPath
);
Parameter
ulFlags
[in] Eine Bitmaske von Flags, die den Typ der im Suchpfad zurückgegebenen Zeichenfolgen steuert. Das folgende Flag kann festgelegt werden:
MAPI_UNICODE
Die zurückgegebenen Zeichenfolgen liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.
lppSearchPath
[out] Ein Zeiger auf einen Zeiger auf eine sortierte Liste von Containereintragsbezeichnern. GetSearchPath speichert die sortierte Liste in einer SRowSet-Struktur . Wenn keine Container in der Adressbuchhierarchie vorhanden sind, wird null in der SRowSet-Struktur zurückgegeben.
Rückgabewert
S_OK
Der Suchpfad wurde erfolgreich abgerufen.
Hinweise
Clients und Dienstanbieter rufen die GetSearchPath-Methode auf, um den Suchpfad abzurufen, der zum Auflösen von Namen mit der ResolveName-Methode verwendet wird. In der Regel rufen Clients die IAddrBook::SetSearchPath-Methode auf, um einen Containersuchpfad im Profil einzurichten, bevor sie GetSearchPath aufrufen, um ihn abzurufen. Das Aufrufen von SetSearchPath ist jedoch optional.
Wenn SetSearchPath noch nie aufgerufen wurde, erstellt GetSearchPath einen Pfad, indem die Hierarchietabellen des Adressbuchs durchgearbeitet werden. Der von GetSearchPath festgelegte Standardsuchpfad besteht aus den folgenden Containern in der folgenden Reihenfolge:
Der erste Container mit Lese-/Schreibberechtigung, in der Regel das persönliche Adressbuch (PAB).
Jeder Container, dessen eigenschaft PR_DISPLAY_TYPE (PidTagDisplayType) auf DT_GLOBAL festgelegt ist. Diese Einstellung gibt an, dass der Container Empfänger enthält.
Der als Standard festgelegte Container, wenn keine Container mit dem flag DT_GLOBAL in der PR_DISPLAY_TYPE-Eigenschaft festgelegt sind und sich der Standardcontainer vom ersten Container mit Lese-/Schreibberechtigung unterscheidet.
Wenn SetSearchPath aufgerufen wurde, erstellt GetSearchPath einen Pfad mithilfe der Adressbuchcontainer, die im Profil gespeichert wurden. GetSearchPath überprüft diesen Pfad, bevor er an den Aufrufer zurückgegeben wird.
Nach dem ersten Aufruf von SetSearchPath müssen nachfolgende Aufrufe von SetSearchPath verwendet werden, um den von GetSearchPath zurückgegebenen Suchpfad zu ändern. Anders ausgedrückt: Der aufrufende Client oder Anbieter empfängt nach dem ersten Aufruf von SetSearchPath nicht den Standardsuchpfad.