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 인터페이스의 instance 대한 포인터입니다. 복사된 각 인터페이스 포인터 에 대해 OnWalkInterface 메서드가 호출됩니다. 이 매개 변수가 제공되지 않으면 복사된 모든 인터페이스 포인터가 AddRef에 전달됩니다.

[out] ppFrame

호출 프레임의 복사본에 대한 ICallFrame 포인터에 대한 포인터입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

프레임을 복사하는 것은 마샬링된 프레임을 경계 해제하는 것과 같습니다. 호출 프레임은 매개 변수 내가 있는 경우에만 복사할 수 있습니다. 호출 프레임이 호출되면 복사할 수 없습니다. 복사 메서드는 인터페이스 포인터를 이진 값으로 복사하며 참조된 개수 조정은 수행되지 않습니다. 그러나 이 동작이 필요한 경우 ICallFrameWalker 에 대한 포인터를 사용할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	callobj.h

추가 정보

ICallFrame