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 |