HrOpenABEntryWithExchangeContext

Gilt für: Outlook 2013 | Outlook 2016

Öffnet die entryID mithilfe des exchange-Adressbuchs, das von pEmsmdbUID identifiziert wird. Diese Funktion funktioniert ähnlich wie IAddrBook::D etails , mit der Ausnahme, dass die Verwendung dieser Funktion sicherstellt, dass das IAddrBook::OpenEntry mit dem erwarteten Exchange-Adressbuchanbieter geöffnet wird.

Eigenschaft	Wert
Headerdatei	abhelp.h
Implementiert von:	MAPI
Aufgerufen von:	Clientanwendungen und Dienstanbieter

HRESULT HrDoABDetailsWithExchangeContext(
  LPMAPISESSION pmsess,
  const MAPIUID *pEmsmdbUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags
);

Parameter

pmsess

[in] Die angemeldete IMAPISession. Es darf nicht NULL sein.

pEmsmdbUID

[in] Ein Zeiger auf eine emsmdbUID, die den Exchange-Dienst identifiziert, der den Exchange-Adressbuchanbieter enthält, den diese Funktion zum Anzeigen von Details zum Eintragsbezeichner verwenden soll. Wenn der Eingangseintragsbezeichner kein Eintragsbezeichner des Exchange-Adressbuchanbieters ist, wird dieser Parameter ignoriert, und der Funktionsaufruf verhält sich wie IAddrBook::D etails. Wenn dieser Parameter NULL oder mapIUID null ist, verhält sich diese Funktion wie IAddrBook::D etails.

pAddrBook

[in] Das Adressbuch, das zum Öffnen des Eintragsbezeichners verwendet wird. Es darf nicht NULL sein.

cbEntryID

[in] Die Byteanzahl des Eintragsbezeichners, der durch den lpEntryID-Parameter angegeben wird.

lpEntryID

[in] Ein Zeiger auf den Eintragsbezeichner, der den zu öffnenden Adressbucheintrag darstellt.

ulFlags

[in] Eine Bitmaske von Flags, die steuert, wie der Eintrag geöffnet wird. Die folgenden Flags können festgelegt werden:

MAPI_BEST_ACCESS

Fordert an, dass der Eintrag mit den maximal zulässigen Netzwerk- und Clientberechtigungen geöffnet wird. Wenn der Client beispielsweise über Lese- und Schreibberechtigungen verfügt, versucht der Adressbuchanbieter, den Eintrag mit Lese- und Schreibberechtigungen zu öffnen. Der Client kann die gewährte Zugriffsebene abrufen, indem die IMAPIProp::GetProps-Methode des geöffneten Eintrags aufgerufen und die eigenschaft PR_ACCESS_LEVEL (PidTagAccessLevel) abgerufen wird.

MAPI_CACHE_ONLY

Verwendet nur das Offlineadressbuch, um die Namensauflösung durchzuführen. Sie können dieses Flag beispielsweise verwenden, um einer Clientanwendung das Öffnen der globalen Adressliste (GAL) im zwischengespeicherten Austauschmodus und den Zugriff auf einen Eintrag in diesem Adressbuch aus dem Cache zu ermöglichen, ohne Datenverkehr zwischen Client und Server zu erzeugen. Dieses Flag wird nur vom Exchange-Adressbuchanbieter unterstützt.

MAPI_DEFERRED_ERRORS

Ermöglicht den erfolgreichen Aufruf, möglicherweise bevor der Eintrag vollständig geöffnet und verfügbar ist, was impliziert, dass nachfolgende Aufrufe des Eintrags einen Fehler zurückgeben können.

MAPI_GAL_ONLY

Verwendet nur die GAL, um die Namensauflösung durchzuführen. Dieses Flag wird nur vom Exchange-Adressbuchanbieter unterstützt.

MAPI_MODIFY

Fordert an, dass der Eintrag mit Lese- und Schreibberechtigungen geöffnet wird. Da Einträge standardmäßig mit schreibgeschütztem Zugriff geöffnet werden, sollten Clients nicht davon ausgehen, dass lese- und schreibberechtigungen erteilt wurden, unabhängig davon, ob MAPI_MODIFY festgelegt ist.

MAPI_NO_CACHE

Verwendet das Offlineadressbuch nicht für die Namensauflösung. Dieses Flag wird nur vom Exchange-Adressbuchanbieter unterstützt.