IMSLogon::OpenEntry
Gilt für: Outlook 2013 | Outlook 2016
Öffnet ein Ordner- oder Nachrichtenobjekt und gibt einen Zeiger auf das -Objekt zurück, um weiteren Zugriff zu ermöglichen.
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 (Interface Identifier, 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 lpInterface-Parameter kann auch auf einen Bezeichner für eine geeignete Schnittstelle für das Objekt festgelegt werden.
ulOpenFlags
[in] Eine Bitmaske von Flags, die steuert, wie das Objekt geöffnet wird. Die folgenden Flags können festgelegt werden:
MAPI_BEST_ACCESS
Das Objekt sollte mit den maximal zulässigen Berechtigungen für den Benutzer und den maximalen Clientanwendungsberechtigungen 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, gibt ein nachfolgendes Aufrufen des Objekts möglicherweise einen Fehler zurück.
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 den weiteren Zugriff auf das im lppUnk-Parameter angegebene Objekt ermöglicht.
Bevor DIE MAPI IMSLogon::OpenEntry aufruft, ermittelt sie zunächst, 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; MAPI ruft IMSLogon::OpenEntry auf, wenn eine IMAPISession::OpenEntry-Methode verarbeitet wird. Objekte, die mit IMSLogon::OpenEntry geöffnet werden, sollten genauso behandelt werden wie Objekte, die mit dem Nachrichtenspeicherobjekt geöffnet wurden. Insbesondere sollten objekte, die mit diesem Aufruf geöffnet wurden, ungültig werden, wenn das Nachrichtenspeicherobjekt freigegeben wird.