IMsgStore::StoreLogoff
Gilt für: Outlook 2013 | Outlook 2016
Aktiviert die ordnungsgemäße Abmeldung des Nachrichtenspeichers.
HRESULT StoreLogoff(
ULONG FAR * lpulFlags
);
Parameter
lpulFlags
[in, out] Eine Bitmaske von Flags, die die Abmeldung vom Nachrichtenspeicher steuert. Bei der Eingabe schließen sich alle für diesen Parameter festgelegten Flags gegenseitig aus. Ein Aufrufer darf nur ein Flag pro Aufruf angeben. Die folgenden Flags sind für Eingaben gültig:
LOGOFF_ABORT
Alle Transportanbieteraktivitäten für diesen Nachrichtenspeicher sollten vor der Abmeldung beendet werden. Die Steuerung wird an den Aufrufer zurückgegeben, nachdem die Aktivität beendet wurde. Wenn eine Transportanbieteraktivität stattfindet, erfolgt die Abmeldung nicht, und es erfolgt keine Änderung des Verhaltens des MAPI-Spoolers oder des Transportanbieters. Wenn sich die Transportanbieteraktivität im Leerlauf befindet, gibt der MAPI-Spooler den Speicher frei.
LOGOFF_NO_WAIT
Der Nachrichtenspeicher sollte nicht auf Nachrichten von Transportanbietern warten, bevor er geschlossen wird. Ausgehende Nachrichten, die zum Senden bereit sind, werden gesendet. Wenn dieser Speicher den Standard-Posteingang enthält, werden alle In-Process-Nachrichten empfangen, und dann wird der weitere Empfang deaktiviert. Wenn alle Aktivitäten abgeschlossen sind, gibt der MAPI-Spooler den Speicher frei, und das Steuerelement wird sofort an den Aufrufer zurückgegeben.
LOGOFF_ORDERLY
Der Nachrichtenspeicher sollte nicht auf Informationen von Transportanbietern warten, bevor er geschlossen wird. Nachrichten, die derzeit verarbeitet werden, sind abgeschlossen, aber es werden keine neuen Nachrichten verarbeitet. Wenn alle Aktivitäten abgeschlossen sind, gibt der MAPI-Spooler den Speicher frei, und das Steuerelement wird sofort an den Speicheranbieter zurückgegeben.
LOGOFF_PURGE
Die Abmeldung sollte genauso funktionieren, als wäre das LOGOFF_NO_WAIT-Flag festgelegt, aber entweder die IXPLogon::FlushQueues-Methode oder die IMAPIStatus::FlushQueues-Methode für die entsprechenden Transportanbieter sollte aufgerufen werden. Das LOGOFF_PURGE-Flag gibt die Steuerung nach Abschluss an den Aufrufer zurück.
LOGOFF_QUIET
Wenn eine Transportanbieteraktivität stattfindet, sollte die Abmeldung nicht erfolgen.
Die folgenden Flags sind für die Ausgabe gültig.
LOGOFF_INBOUND
Eingehende Nachrichten sind derzeit eingetroffen.
LOGOFF_OUTBOUND
Ausgehende Nachrichten werden gerade gesendet.
LOGOFF_OUTBOUND_QUEUE
Ausgehende Nachrichten sind ausstehend (d. h., sie befinden sich im Postausgang).
Rückgabewert
S_OK
Die Abmeldung wurde erfolgreich abgeschlossen.
Hinweise
Die IMsgStore::StoreLogoff-Methode übt während des Abmeldungsprozesses die Kontrolle über die Interaktion zwischen Nachrichtenspeicher und Transportanbietern aus. Das Aufrufen von StoreLogoff ist nur für Nachrichtenspeicher gültig, die nur vom Aufrufer verwendet werden. Wenn beispielsweise zwei Clients denselben Nachrichtenspeicher verwenden und einer von ihnen StoreLogoff aufruft, wird der Nachrichtenspeicher sofort freigegeben, und die Steuerung wird an den aufrufenden Client zurückgegeben.
Hinweise für Implementierer
Speichern Sie die An StoreLogoff übergebenen Flags, und übergeben Sie sie, wenn Sie die IMAPISupport::StoreLogoffTransports-Methode aufrufen. Rufen Sie StoreLogoffTransports erst auf, wenn die Verweisanzahl des Nachrichtenspeichers auf 0 (null) fällt. Mehrere Aufrufe von StoreLogoffTransports überschreiben einfach die gespeicherten Flags.
Wenn storeLogoff nicht aufgerufen wurde, bevor die Verweisanzahl des Nachrichtenspeichers 0 (null) erreicht, legen Sie das flag LOGOFF_ABORT im ulFlags-Parameter fest, den Sie an StoreLogoffTransports übergeben.