Imex_Topo_Import_Logged()
摘要
从自描述文本文件导入拓扑,使用自定义日志过程记录错误。
语法
Imex_Topo_Import_Logged (file_name, log_proc)
| 参数 | 类型 | 说明 |
|---|---|---|
file_name |
char * |
待导入文本文件的完整路径 |
log_proc |
ImexT_Log_Proc |
用于记录错误的过程,或 PRGC_NIL(参见详情) |
返回类型
PrgT_Compcode
失败时返回 PrgC_Compcode_Failure;成功时返回 PrgC_Compcode_Success。
头文件
imex.h
详情
从自描述文本文件导入网络拓扑到当前场景。文本文件必须符合名为 TEF 的文档化格式。调用此函数可自动化在当前场景内创建对象的过程。该函数完成所有的解析、对象创建以及对象属性赋值。导入之前,当前网络会被清空(所有节点和链路均被移除)。
在输入文本文件中发现的错误将使用 log_proc 指定的日志过程记录。该日志过程可以是通过 Imex_Default_Log_Proc_Get() 获取的默认过程,也可以是用户自行编写的过程。日志过程回调的原型见 ImexT_Log_Proc。如果 log_proc 为 PRGC_NIL,则不记录任何消息。