IXPLogon::ValidateState
Gilt für: Outlook 2013 | Outlook 2016
Überprüft die externe status des Transportanbieters.
HRESULT ValidateState(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameter
ulUIParam
[in] Ein Handle für das übergeordnete Fenster aller Dialogfelder oder Fenster, die von dieser Methode angezeigt werden.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie die status-Überprüfung ausgeführt wird, und die Ergebnisse der status-Überprüfung. Die folgenden Flags können festgelegt werden:
ABORT_XP_HEADER_OPERATION
Der Benutzer hat den Vorgang in der Regel abgebrochen, indem er in einem Dialogfeld auf die Schaltfläche Abbrechen geklickt hat. Der Transportanbieter hat die Möglichkeit, weiterhin an dem Vorgang zu arbeiten, oder er kann den Vorgang abbrechen und MAPI_E_USER_CANCELED zurückgeben.
CONFIG_CHANGED
Überprüft den Status der derzeit geladenen Transportanbieter, indem der MAPI-Spooler seine IXPLogon::AddressTypes-Methode aufruft . Dieses Flag bietet dem MAPI-Spooler auch die Möglichkeit, kritische Transportanbieterfehler zu korrigieren, ohne Clientanwendungen zu zwingen, sich abzumelden und sich dann erneut anzumelden.
FORCE_XP_CONNECT
Der Benutzer hat einen Verbindungsvorgang ausgewählt. Wenn dieses Flag mit dem REFRESH_XP_HEADER_CACHE- oder PROCESS_XP_HEADER_CACHE-Flag verwendet wird, erfolgt die Verbindungsaktion ohne Zwischenspeicherung.
FORCE_XP_DISCONNECT
Der Benutzer hat einen Vorgang zum Trennen ausgewählt. Wenn dieses Flag mit REFRESH_XP_HEADER_CACHE oder PROCESS_XP_HEADER_CACHE verwendet wird, erfolgt die Trennungsaktion ohne Zwischenspeicherung.
PROCESS_XP_HEADER_CACHE
Einträge in der Headercachetabelle sollten verarbeitet werden, alle nachrichten, die mit dem MSGSTATUS_REMOTE_DOWNLOAD-Flag markiert sind, und alle nachrichten, die mit dem MSGSTATUS_REMOTE_DELETE-Flag gekennzeichnet sind, sollten gelöscht werden. Nachrichten, für die sowohl MSGSTATUS_REMOTE_DOWNLOAD als auch MSGSTATUS_REMOTE_DELETE festgelegt sind, sollten verschoben werden.
REFRESH_XP_HEADER_CACHE
Eine neue Liste von Nachrichtenkopfzeilen sollte heruntergeladen werden, und alle Kennzeichnungsflags für Nachrichten status sollten gelöscht werden.
SUPPRESS_UI
Verhindert, dass der Transportanbieter eine Benutzeroberfläche anzeigt.
Rückgabewert
S_OK
Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben.
MAPI_E_BUSY
Ein weiterer Vorgang wird ausgeführt. Der Vorgang sollte abgeschlossen werden dürfen, oder es sollte beendet werden, bevor dieser Vorgang versucht wird.
MAPI_E_NO_SUPPORT
Der beteiligte Remotetransportanbieter unterstützt keine Benutzeroberfläche, und die Clientanwendung selbst sollte das Dialogfeld anzeigen.
MAPI_E_USER_CANCEL
Der Benutzer hat den Vorgang in der Regel abgebrochen, indem er in einem Dialogfeld auf die Schaltfläche Abbrechen geklickt hat.
Hinweise
Der MAPI-Spooler ruft die IXPLogon::ValidateState-Methode auf, um Aufrufe der IMAPIStatus::ValidateState-Methode für das status-Objekt zu unterstützen. Der Transportanbieter sollte auf den IXPLogon::ValidateState-Aufruf genau so reagieren, als hätte der MAPI-Spooler ein status -Objekt für die aktuelle Anmeldesitzung geöffnet und dann IMAPIStatus::ValidateState für dieses Objekt aufgerufen.
Zur Unterstützung der Implementierung von IMAPIStatus::ValidateState ruft der MAPI-Spooler IXPLogon::ValidateState für alle Anmeldeobjekte für alle aktiven Transportanbieter auf, die in einer Profilsitzung ausgeführt werden.