共用方式為

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