prg_tfile_path_rediscover()
摘要
在所有模型目录中搜索指定的模型文件,并返回该文件的完整操作系统路径。
语法
prg_tfile_path_rediscover (model_name, type, path_buf, buflen)
| 参数 | 类型 | 说明 |
|---|---|---|
model_name |
const char * |
目标模型的名称。 |
type |
PrgT_Tfile_Type |
目标模型文件的类型。用于指定模型类型的常量列表见表 5 Tfile 包符号常量。 |
path_buf |
char * |
若找到文件,用于存放路径字符串的缓冲区。 |
buflen |
int |
path_buf 的长度。 |
返回类型
PrgT_Compcode
若找不到模型文件或 type 无效,返回 PrgC_Compcode_Failure;否则返回 PrgC_Compcode_Success。
头文件
prg_file_funcs.h
详情
此函数在所有模型目录中搜索指定的模型文件(由名称和类型指定)。如果找到该文件,函数返回 PrgC_Compcode_Success,将完整文件路径写入 path_buf,并将该文件注册到类型化文件(tfile)系统。如果路径长度超过 buflen,将被截断为 buflen - 1 个字符。
此函数可用于:
- 查找并注册在 tfile 系统之外创建或移动的文件(例如由外部进程或在应用程序进程内通过原始 fopen 调用产生)
- 注册该文件已在 tfile 系统之外被删除这一事实