IPersistMessage::HandsOffMessage
适用于:Outlook 2013 | Outlook 2016
使窗体释放其当前消息。
HRESULT HandsOffMessage( void );
参数
无
返回值
S_OK
消息已成功释放。
备注
表单转换为两种 HandsOff 状态:
当窗体处于这两种状态之一时,它正在永久存储。
针对实现者的说明
当表单查看器在窗体处于 Normal 或 NoScribble 状态时调用 IPersistMessage::HandsOffMessage 方法时,对嵌入在当前消息中的每个 OLE 对象和 IPersistStorage::HandsOffStorage 方法上递归调用 HandsOffMessage 方法。 然后释放当前消息以及所有嵌入的消息和 OLE 对象。 如果窗体处于“正常”状态,请转换为 HandsOffFromNormal 状态。 如果窗体处于 NoScribble 状态,请转换为 HandsOffAfterSave 状态。 成功转换后,调用消息的 IUnknown::Release 方法并返回S_OK。
当表单查看器在窗体处于 HandsOff 状态之一时调用 HandsOffMessage 时,返回E_UNEXPECTED。
有关窗体的不同状态的详细信息,请参阅 窗体状态。 有关如何使用存储对象的 HandsOff 状态的详细信息,请参阅 IPersistStorage::HandsOffStorage 方法。