IMSLogon::OpenStatusEntry
Gilt für: Outlook 2013 | Outlook 2016
Öffnet ein status-Objekt.
HRESULT OpenStatusEntry(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPVOID FAR * lppEntry
);
Parameter
lpInterface
[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID) für das zu öffnende status -Objekt. Die Übergabe von NULL gibt an, dass die Standardschnittstelle für das Objekt zurückgegeben wird (in diesem Fall die IMAPIStatus-Schnittstelle ). Der lpInterface-Parameter kann auch auf einen Bezeichner für eine geeignete Schnittstelle für das Objekt festgelegt werden.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie das status -Objekt geöffnet wird. Das folgende Flag kann festgelegt werden:
MAPI_MODIFY
Fordert Lese-/Schreibberechtigungen an. Standardmäßig werden Objekte mit schreibgeschützter Berechtigung erstellt, und Clientanwendungen sollten nicht unter der Annahme funktionieren, dass lese-/schreibberechtigungen erteilt wurden.
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
Nachrichtenspeicheranbieter implementieren die IMSLogon::OpenStatusEntry-Methode, um ein status-Objekt zu öffnen. Dieses status-Objekt wird dann verwendet, um Clients das Aufrufen von IMAPIStatus-Methoden zu ermöglichen. Clients können beispielsweise die IMAPIStatus::SettingsDialog-Methode verwenden, um die Anmeldesitzung des Nachrichtenspeichers neu zu konfigurieren, oder die IMAPIStatus::ValidateState-Methode , um den Status der Anmeldesitzung des Nachrichtenspeichers zu überprüfen.