Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Outlook 2013 | Outlook 2016
Öffnet einen Ordner oder ein Nachrichtenobjekt und gibt einen Zeiger auf das Objekt zurück, um weiteren Zugriff bereitzustellen.
HRESULT OpenEntry(
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPCIID lpInterface,
ULONG ulOpenFlags,
ULONG FAR * lpulObjType,
LPUNKNOWN FAR * lppUnk
);
Parameter
cbEntryID
[in] Die Größe des Eintragsbezeichners in Bytes, auf die der lpEntryID-Parameter verweist.
lpEntryID
[in] Ein Zeiger auf die Adresse des Eintragsbezeichners des zu öffnenden Ordners oder Nachrichtenobjekts.
lpInterface
[in] Ein Zeiger auf den Schnittstellenbezeichner (IID) für das Objekt. Die Übergabe von NULL gibt an, dass das Objekt in die Standardschnittstelle für ein solches Objekt umgewandelt wird. Der Parameter lpInterface kann auch auf eine Kennung für eine geeignete Schnittstelle für das Objekt gesetzt werden.
ulOpenFlags
[in] Eine Bitmaske von Flags, die steuert, wie das Objekt geöffnet wird. Eine der folgenden Werte kann festgelegt werden:
MAPI_BEST_ACCESS
Das Objekt sollte mit den maximal zulässigen Berechtigungen für den Benutzer und den maximalen Berechtigungen der Clientanwendung geöffnet werden. Wenn der Client beispielsweise über Lese-/Schreibberechtigungen verfügt, wird das Objekt mit Lese-/Schreibberechtigung geöffnet; wenn der Client über schreibgeschützte Berechtigungen verfügt, wird das Objekt mit schreibgeschützter Berechtigung geöffnet. Der Client kann die Berechtigungsstufe abrufen, indem er die Eigenschaft PR_ACCESS_LEVEL (PidTagAccessLevel) abruft.
MAPI_DEFERRED_ERRORS
Der Aufruf kann auch dann erfolgreich ausgeführt werden, wenn das zugrunde liegende Objekt für die aufrufende Anwendung nicht verfügbar ist. Wenn das Objekt nicht verfügbar ist, kann ein nachfolgender Aufruf des Objekts einen Fehler zurückgeben.
MAPI_MODIFY
Fordert Lese-/Schreibberechtigungen an. Standardmäßig werden Objekte mit schreibgeschützter Berechtigung erstellt, und Clients sollten nicht unter der Annahme funktionieren, dass lese-/schreibberechtigungen erteilt wurden.
lpulObjType
[out] Ein Zeiger auf den Typ des geöffneten Objekts.
lppUnk
[out] Ein Zeiger auf den Zeiger auf das geöffnete Objekt.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.
Hinweise
MAPI ruft die IMSLogon::OpenEntry-Methode auf, um einen Ordner oder eine Nachricht in einem Nachrichtenspeicher zu öffnen. MAPI übergibt den Eintragsbezeichner des zu öffnenden Objekts. Der Nachrichtenspeicheranbieter sollte einen Zeiger zurückgeben, der weiteren Zugriff auf das im Parameter lppUnk angegebene Objekt ermöglicht.
Bevor MAPI IMSLogon::OpenEntry aufruft, wird zunächst ermittelt, dass der angegebene Nachrichten- oder Ordnereintragsbezeichner mit einer von diesem Nachrichtenspeicheranbieter registrierten ID übereinstimmt. Weitere Informationen dazu, wie Speicheranbieter Eintragsbezeichner registrieren, finden Sie unter IMAPISupport::SetProviderUID.
IMSLogon::OpenEntry ist identisch mit der IMsgStore::OpenEntry-Methode des Nachrichtenspeicherobjekts, mit der Ausnahme, dass der Client nicht IMSLogon::OpenEntry nicht aufruft; MAPI ruft IMSLogon::OpenEntry auf, wenn eine IMAPISession::OpenEntry-Methode verarbeitet wird. Objekte, die mit IMSLogon::OpenEntry geöffnet wurden, sollten genau wie Objekte behandelt werden, die mithilfe des Nachrichtenspeicherobjekts geöffnet wurden. Insbesondere sollten mit diesem Aufruf geöffnete Objekte ungültig gemacht werden, wenn das Nachrichtenspeicherobjekt freigegeben wird.