ICallFrame::Copy 方法 (callobj.h)

创建此调用帧及其所有相关数据的副本。

警告 调用帧不会自动清理复制的数据。 因此,返回副本后,用户负责对帧副本调用 Free 。 必须执行此操作以避免内存泄漏。
 

语法

HRESULT Copy(
  [in]  CALLFRAME_COPY   copyControl,
  [in]  ICallFrameWalker *pWalker,
  [out] ICallFrame       **ppFrame
);

参数

[in] copyControl

通过确定复制的调用帧数据对父帧的生存期依赖关系,确定是否可与父帧中的数据共享。 有关值列表,请参阅 CALLFRAME_COPY 枚举。 如果设置了CALLFRAME_COPY_NESTED标志,则客户端将负责使用复制的调用帧,其生存期嵌套在其父帧的生存期内,使数据可共享。 如果设置了CALLFRAME_COPY_INDEPENDENT,则复制的帧的生存期将独立于父帧。

[in] pWalker

指向 ICallFrameWalker 接口实例的指针。 将为每个复制的接口指针调用 OnWalkInterface 方法。 如果未提供此参数,则复制的任何接口指针都将传递到 AddRef

[out] ppFrame

指向调用帧副本的 ICallFrame 指针的指针。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

复制帧就像取消封送帧一样。 仅当调用帧具有参数内时,才能复制该调用帧。 如果调用调用帧,则无法复制它。 复制方法将接口指针复制为二进制值,并且不执行引用的计数调整。 但是,如果需要此行为,则可以使用指向 ICallFrameWalker 的 指针。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 callobj.h

另请参阅

ICallFrame