Ets_Output_Obj_Value_Get()

摘要

在给定上下文中访问与给定对象关联的输出值。

语法

Ets_Output_Obj_Value_Get (cxt_ptr, obj_hndl, output_value_name, value_pptr)
参数 类型 说明
cxt_ptr EtsT_Output_Context * 所需的输出上下文。
obj_hndl EtsT_Obj_Handle 要获取其输出数据的对象。
output_value_name const char * 要获取的输出值的名称。
value_pptr void * 用于存放指向所请求输出值的指针的区域。该内存必须对所输出的数据类型有效。

返回类型

EtsT_Output_Status

操作状态(参见详情)。

头文件

ets_api_output.h

详情

必须已经运行了所需类型(基于上下文模式)的输出分析。此外,所请求的输出值必须存在有效的已注册值。

输出值被放入 value_pptr。数据归调用者所有。复杂数据会被复制到 value_pptr。调用者必须知道该输出值对应的数据类型并传入合适的值。一种常见用法是获取字符串值,此时应传入 char**(不再需要时调用者必须自行释放该内存)。其他用法参见示例。

如果所请求的值尚无值缓存,则会创建该缓存并保留,以便后续请求更快访问。

返回的输出状态为以下符号常量之一:

  • EtsC_Output_Status_SUCCESS——操作成功
  • EtsC_Output_Status_UNKNOWN_VALUE——output_value_name 指定了一个无法处理或未注册的输出值
  • EtsC_Output_Status_NO_RESULTS——分析尚未运行
  • EtsC_Output_Status_UNKNOWN_OBJECT——分析已运行,但该对象没有任何结果
  • EtsC_Output_Status_FAILURE——未指明的失败

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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