HrOpenABEntryWithProviderUID

Gilt für: Outlook 2013 | Outlook 2016

Öffnet die entryID mithilfe des exchange-Adressbuchs, das von pEmsabpUID identifiziert wird. Diese Funktion funktioniert ähnlich wie IAddrBook::OpenEntry , mit der Ausnahme, dass mit dieser Funktion sichergestellt wird, dass IAddrBook::OpenEntry mithilfe des erwarteten Exchange-Adressbuchanbieters geöffnet wird.

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

HRESULT HrOpenABEntryWithProviderUID(
  const MAPIUID *pEmsabpUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Parameter

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.

lpInterface

[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID) der Schnittstelle, die für den Zugriff auf den geöffneten Eintrag verwendet wird. Das Übergeben von NULL gibt die Standardschnittstelle des -Objekts zurück. Für Messagingbenutzer ist die Standardschnittstelle IMailUser: IMAPIProp. Bei Verteilerlisten lautet dies IDistList : IMAPIContainerund für Container IABContainer : IMAPIContainer. Aufrufer können lpInterface auf die entsprechende Standardschnittstelle oder eine Schnittstelle in der Vererbungshierarchie festlegen.

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

Verwenden Sie 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

Verwenden Sie 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

Verwenden Sie nicht das Offlineadressbuch, um die Namensauflösung durchzuführen. Dieses Flag wird nur vom Exchange-Adressbuchanbieter unterstützt.

lpulObjType

[out] Ein Zeiger auf den Typ des geöffneten Eintrags.

lppUnk

[out] Ein Zeiger auf einen Zeiger des geöffneten Eintrags.