Export (0) Print
Expand All

ICallFrame::Copy method

Creates a copy of this call frame and all of its associated data.

Warning  The call frame does not clean up the copied data automatically. Therefore once the copy is returned then the user is responsible for calling Free on the frame copy. This must be done to avoid a memory leak.

Syntax


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

Parameters

copyControl [in]

Determines whether the copied call frame data can be shared with data in the parent frame by determining its lifetime dependency on the parent frame. For a list of values, see the CALLFRAME_COPY enumeration. If the CALLFRAME_COPY_NESTED flag is set, then the client will be responsible for using the copied call frame in a manner that its lifetime is nested in the lifetime of its parent frame making the data sharable. If the CALLFRAME_COPY_INDEPENDENT is set, then the lifetime of the copied frame will be independent of the parents.

pWalker [in]

A pointer to an instance of the ICallFrameWalker interface. The OnWalkInterface method will be called for each interface pointer that is copied. If this parameter is not provided, then any interface pointer that is copied will be passed to AddRef.

ppFrame [out]

A pointer to an ICallFrame pointer to a copy of the call frame.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Copying a frame is like unmarshalling a marshaled frame. The call frame can only be copied if it has in-parameters. If the call frame is invoked, it cannot be copied. The copy method copies interface pointers as binary values and no referenced count adjustments are performed. But if this behavior is desired, then a pointer to ICallFrameWalker can be used.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Callobj.h

IDL

Callobj.idl

IID

IID_ICallFrame is defined as D573B4B0-894E-11d2-B8B6-00C04FB9618A

See also

ICallFrame

 

 

Community Additions

ADD
Show:
© 2014 Microsoft