Ets_Obj_Attr_Symbol_Get_Sized()
摘要
使用带长度限制的缓冲区获取符号映射(symbol map)属性中符号部分的值。
语法
Ets_Obj_Attr_Symbol_Get_Sized (obj_hndl, attr_name, size_ptr, symbol_buf_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
obj_hndl |
EtsT_Obj_Handle |
目标对象的句柄。 |
attr_name |
const char * |
目标属性的名称。 |
size_ptr |
size_t * |
调用时,为 val_ptr 的大小。返回时,为属性符号的实际大小(包含结尾的 null 字符)。 |
symbol_buf_ptr |
char * |
返回符号的值。 |
返回类型
EtsT_Compcode
若属性存在、为符号属性且有效则返回 EtsC_Compcode_Success,否则返回 EtsC_Compcode_Failure。
头文件
ets_api_obj.h
详情
该函数与 Ets_Obj_Attr_Symbol_Get() 类似,区别在于它多了一个大小参数,返回属性值时不会越过 symbol_buf_ptr 缓冲区的边界。(如果 size_ptr 为 NULL,该函数的行为与 Ets_Obj_Attr_Symbol_Get() 完全相同。)
如果符号值大于 symbol_buf_ptr,将返回截断后的字符串。
通过 size_ptr 可以检测缓冲区大小问题,并重新分配缓冲区以容纳所请求的属性值。示例参见 Ets_Obj_Attr_Get_Sized()。