Ets_Obj_List_File_Read()
摘要
根据选择集文件中指定的对象创建一个列表。
语法
Ets_Obj_List_File_Read (tfile_name, obj_lpptr)
| 参数 | 类型 | 说明 |
|---|---|---|
tfile_name |
const char * |
要读取的选择集文件(不含扩展名的基本名称)。该文件所在目录必须列在 mod_dirs 中。 |
obj_lpptr |
EtsT_Obj_List ** |
指向该函数所创建列表的指针。 |
返回类型
EtsT_Compcode
若能创建列表则返回 EtsC_Compcode_Success(即使部分名称无法解析为实际网络对象);若发生任何错误则返回 EtsC_Compcode_Failure。
头文件
ets_api_obj.h
详情
该函数读取一个选择集 tfile,并为 tfile 中命名且存在于当前场景中的每个对象创建指针列表。该函数不会创建对象;tfile 中不在(或无法识别于)当前场景中的对象将被忽略。调用者拥有该函数创建的列表,不再需要时应使用 Ets_Obj_List_Destroy() 将其销毁。