IPersistMessage::HandsOffMessage

适用于:Outlook 2013 | Outlook 2016

使窗体释放其当前消息。

HRESULT HandsOffMessage( void );

参数

返回值

S_OK

消息已成功释放。

备注

表单转换为两种 HandsOff 状态:

当窗体处于这两种状态之一时,它正在永久存储。

针对实现者的说明

当表单查看器在窗体处于 NormalNoScribble 状态时调用 IPersistMessage::HandsOffMessage 方法时,对嵌入在当前消息中的每个 OLE 对象和 IPersistStorage::HandsOffStorage 方法上递归调用 HandsOffMessage 方法。 然后释放当前消息以及所有嵌入的消息和 OLE 对象。 如果窗体处于“正常”状态,请转换为 HandsOffFromNormal 状态。 如果窗体处于 NoScribble 状态,请转换为 HandsOffAfterSave 状态。 成功转换后,调用消息的 IUnknown::Release 方法并返回S_OK。

当表单查看器在窗体处于 HandsOff 状态之一时调用 HandsOffMessage 时,返回E_UNEXPECTED。

有关窗体的不同状态的详细信息,请参阅 窗体状态。 有关如何使用存储对象的 HandsOff 状态的详细信息,请参阅 IPersistStorage::HandsOffStorage 方法。

另请参阅

IPersistMessage : IUnknown

窗体状态