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;
}