Ets_Topo_Parent_Attr_Get_Sized()
摘要
根据属性的对象句柄和名称,使用带大小限定的缓冲区获取顶层属性的值。
语法
Ets_Topo_Parent_Attr_Get_Sized (child_obj_hndl, attr_name, size_ptr, result_value_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
child_obj_hndl |
EtsT_Obj_Handle |
子对象的句柄。 |
attr_name |
const char * |
所关注的顶层属性的名称。 |
size_ptr |
size_t * |
调用时,为 result_value_ptr 的大小。返回时,为属性值的实际大小(对于字符串,包含结尾的空字符)。 |
result_value_ptr |
void * |
所关注属性的值。(关于此参数的详情参见 Ets_Obj_Attr_Get()(第 958 页)。) |
返回类型
EtsT_Compcode
若获取到属性值,返回 EtsC_Compcode_Success;否则返回 EtsC_Compcode_Failure。
头文件
ets_api_topo.h
详情
此函数与 Ets_Topo_Parent_Attr_Get() 类似,不同之处在于它多了一个大小参数,返回属性值时不会溢出 result_value_ptr 缓冲区。(如果 size_ptr 为 NULL,此函数的行为与 Ets_Topo_Parent_Attr_Get() 完全相同。)
对于大于 result_value_ptr 的字符串属性值,返回截断后的字符串。对于其他数据类型,如果属性值过大,result_value_ptr 保持为空。
size_ptr 使你能够检测缓冲区大小问题并重新分配缓冲区以容纳所请求的属性值。示例参见 Ets_Obj_Attr_Get_Sized()(第 960 页)。