IPersistMessage::HandsOffMessage
Gilt für: Outlook 2013 | Outlook 2016
Bewirkt, dass das Formular seine aktuelle Nachricht freigibt.
HRESULT HandsOffMessage( void );
Parameter
Keine
Rückgabewert
S_OK
Die Nachricht wurde erfolgreich veröffentlicht.
Hinweise
Formulare werden in zwei HandsOff-Zustände übergehen:
Wenn sich ein Formular in einem dieser Zustände befindet, wird es gerade dauerhaft gespeichert.
Hinweise für Implementierer
Wenn ein Formular-Viewer die IPersistMessage::HandsOffMessage-Methode aufruft, während sich ihr Formular im Normal - oder NoScribble-Zustand befindet, rufen Sie HandsOffMessage rekursiv für jede in die aktuelle Nachricht eingebettete Nachricht und die IPersistStorage::HandsOffStorage-Methode für jedes ole-Objekt auf, das in die aktuelle Nachricht eingebettet ist. Geben Sie dann die aktuelle Nachricht und alle eingebetteten Nachrichten und OLE-Objekte frei. Wenn sich Ihr Formular im Normalzustand befand, wechseln Sie in den Zustand HandsOffFromNormal. Wenn sich Ihr Formular im Zustand NoScribble befand, wechseln Sie in den Zustand HandsOffAfterSave. Rufen Sie nach einem erfolgreichen Übergang die IUnknown::Release-Methode der Nachricht auf, und geben Sie S_OK zurück.
Wenn ein Formular-Viewer HandsOffMessage aufruft, während sich Ihr Formular in einem der HandsOff-Zustände befindet, geben Sie E_UNEXPECTED zurück.
Weitere Informationen zu den verschiedenen Zuständen eines Formulars finden Sie unter Formularzustände. Weitere Informationen zum Arbeiten mit dem HandsOff-Zustand von Speicherobjekten finden Sie unter der IPersistStorage::HandsOffStorage-Methode .