Ets_Nt_Clipboard_Paste_Echo_Objects_Get()

注意: 需要 OPNET Development Kit

摘要

获取已粘贴对象的剪贴板副本,以及原先附着于该对象的任何对象的副本。

语法

Ets_Nt_Clipboard_Paste_Echo_Objects_Get (installed_obj_hndl, connected_echo_obj_lptr)
参数 类型 说明
installed_obj_hndl EtsT_Obj_Handle 刚粘贴的剪贴板对象的句柄
connected_echo_obj_lptr EtsT_Obj_List * 用于返回已连接对象副本的列表指针

返回类型

EtsT_Obj_Handle

已安装对象的剪贴板副本的句柄。

头文件

ets_api_nt_cback.h

详情

此函数返回与指定对象(installed_obj_hndl)对应的剪贴板对象的句柄,该对象是粘贴操作的结果而刚刚被安装。只有当函数从用 Ets_Nt_Object_Install_Callback_Register() 注册的回调函数中调用,且 installed_obj_hndl 指定的对象是正在安装的对象之一时,返回的对象句柄才有效。

如果通过 connected_echo_obj_lptr 传入一个已初始化的空对象列表,此函数还会返回原先附着于所返回剪贴板对象的对象的“回声”(echo)。这些回声对象是原始对象的副本,具有相同的属性集,但不属于任何网络模型。其中一些回声对象也可能位于剪贴板中(并与指定对象一起被粘贴),但另一些可能纯粹为此函数而保留。

这些回声对象的一个用途是访问已粘贴链路的原始端点上的协议特定属性。例如:

. . .
Ets_Nt_Object_Install_Callback_Register (install_callback, OPC_NIL);
. . .

static void
install_callback (EtsT_Obj_Handle *obj_array, int array_size, void *state_ptr, EtsT_Nt_Object_Install_Src source)
   {
   FIN (install_callback);

   for (int i = 0; i < array_size; i++)
      {
      /* Get next valid installed object */
      EtsT_Obj_Handle pasted_obj_hndl = obj_array [i];
      if (Ets_Obj_Invalid (pasted_obj_hndl))
         continue;

      /* Find the desired link object */
      char name [VOSC_STR_LEN];
      Ets_Obj_Attr_Get (pasted_obj_hndl, "name", name);
      if (name != "my_link")
         continue;

      /* Get clipboard echo objects for the desired link object */
      EtsT_Obj_Handle src_link_hndl;
      EtsT_Obj_List *src_nodes_lptr = Ets_Obj_List_Create ();
      src_link_hndl = Ets_Nt_Clipboard_Paste_Echo_Objects_Get (pasted_obj_hndl, src_nodes_lptr);

      /* Get source nodes */
      EtsT_Obj_Handle src_node_a_hndl = Ets_Obj_List_Object_Get (src_nodes_lptr, 0);
      EtsT_Obj_Handle src_node_b_hndl = Ets_Obj_List_Object_Get (src_nodes_lptr, 1);

      /* Process as needed */
      . . .

      Ets_Obj_List_Destroy (src_nodes_lptr);
      }

   FOUT;
   }

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com