HrOpenABEntryWithResolvedRow

Gilt für: Outlook 2013 | Outlook 2016

Führt dieselbe Funktion wie HrOpenABEntryWithExchangeContext aus, mit der Ausnahme, dass die emsabpUID automatisch aus der aufgelösten Zeile abgerufen und die entryID geöffnet wird.

HRESULT HrOpenABEntryWithResolvedRow(
  LPSRow prwResolved,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Parameter

prwResolved

[in] Ein Zeiger auf die aufgelöste Zeile, die verwendet wird, um die emsabpUID abzurufen und die entryID zu öffnen.

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

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.

lpulObjType

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

lppUnk

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