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 ein Statusobjekt.
HRESULT OpenStatusEntry(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPVOID FAR * lppEntry
);
Parameter
lpInterface
[in] Ein Zeiger auf den Interface Identifier (IID) für das zu öffnende Statusobjekt. Die Übergabe von NULL bedeutet, dass die Standardschnittstelle für das Objekt zurückgegeben wird (in diesem Fall die Schnittstelle IMAPIStatus). Der Parameter lpInterface kann auch auf eine Kennung für eine geeignete Schnittstelle für das Objekt gesetzt werden.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie das Statusobjekt geöffnet wird. Das folgende Flag kann festgelegt werden:
MAPI_MODIFY
Fordert Lese-/Schreibrechte an. Standardmäßig werden Objekte mit einer Nur-Lese-Berechtigung erstellt, und Client-Anwendungen sollten nicht mit der Annahme arbeiten, dass eine Lese-/Schreibberechtigung erteilt wurde.
lpulObjType
[out] Ein Zeiger auf den Typ des geöffneten Objekts.
lppEntry
[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
Anbieter von Nachrichtenspeichern implementieren die Methode IMSLogon::OpenStatusEntry, um ein Statusobjekt zu öffnen. Dieses Statusobjekt wird dann verwendet, damit Clients IMAPIStatus-Methoden aufrufen können. So können Clients beispielsweise die Methode IMAPIStatus::SettingsDialog verwenden, um die Anmeldesitzung des Nachrichtenspeichers neu zu konfigurieren, oder die Methode IMAPIStatus::ValidateState, um den Status der Anmeldesitzung des Nachrichtenspeichers zu überprüfen.