Ets_Obj_Attr_Get_As_String_Sized()

摘要

以字符串形式获取给定 ETS 对象某属性的值,并使用带长度限制的缓冲区。

语法

Ets_Obj_Attr_Get_As_String_Sized (obj_hndl, attr_name, size_ptr, value_buf)
参数 类型 说明
obj_hndl EtsT_Obj_Handle 目标对象的句柄。
attr_name const char * 目标属性的名称。
size_ptr size_t * 调用时为 val_ptr 的大小。
返回时为属性值字符串的实际大小(包含结尾的空字符)。
value_buf char * 用于填充属性值字符串表示的缓冲区。

返回类型

EtsT_Compcode

若成功获取属性值则返回 EtsC_Compcode_Success,否则返回 EtsC_Compcode_Failure。

头文件

ets_api_obj.h

详情

该函数与 Ets_Obj_Attr_Get_As_String() 类似,区别在于它带有一个大小参数,返回属性值时不会越界写坏 value_buf 缓冲区。(若 size_ptr 为 NULL,该函数的行为与 Ets_Obj_Attr_Get_As_String() 完全相同。)

若字符串属性值大于 value_buf,返回的是截断后的字符串。

size_ptr 让你能够检测缓冲区大小问题,并重新分配缓冲区以容纳所请求的属性值。示例参见 Ets_Obj_Attr_Get_Sized()。

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