ifilemgr 接口.pptVIP

IFileMgr /IFile接口 文件访问接口 在BREW中，对文件操作主要有两个接口IFileMgr接口和IFile接口 IFileMgr 接口 接口函数用于创建、删除和重命名文件/目录， 并提供获取文件和目录信息。 IFile接口 主要提供对文件的读read、写write、定位读写指针seek等操作。 访问文件的权限 IFileMgr /IFile接口要求应用程序必须具有 PL_FILE（文件）或 PL_SYSTEM（全部）权限级别，才能在应用程序的模块目录中创建文件和目录. 上述权限可在MIF编辑器中设置 BREW中的文件名 在BREW 3.0之前，文件名和目录名不区分大小写。如果为 IFileMgr（或其它相关 API）指定了文件或目录名，文件名将全部变成小写。例如，“Foo.bar” 文件名将作为 “foo.bar” 处理。 从BREW 3.0 开始，BREW 文件的名称空间已扩展，允许应用程序以区分大小写的方式命名 BREW 文件系统中的任何文件和目录。使文件名以 fs:/ 开头来访问新的 BREW 文件名称空间。不以 fs:/ 开头的文件名解释为向后兼容。 在 fs:/ 名称空间中，以下路径具有特殊含义： “fs:/” (AEEFS_ROOT_DIR)： BREW 文件名称空间的根目录。 fs:/~/ (AEEFS_HOME_DIR)： 这是表示当前在运行应用程序目录的快捷方式。 它映射到 fs:/mod/modid，其中 modid 为当前在运行应用程序的模块 ID。 fs:/mod/ (AEEFS_MOD_DIR)： 所有模块目录的位置。 fs:/mif/ (AEEFS_MIF_DIR)： 所有 BREW MIF 文件的位置。 fs:/shared/ (AEEFS_SHARED_DIR)： Shared 的新名称。 该名称可用以与其它名称区分大小写的应用程序共享文件。 “fs:/address/” (AEEFS_ADDRESS_DIR)： 地址簿目录的位置。 fs:/ringers/ (AEEFS_RINGERS_DIR)： 设备振铃目录的位置。 应用程序必须有 PL_RINGER_WRITE（振铃目录的写权限），才能访问此目录中的文件。 使用 IFileMgr 接口的步骤： 调用 ISHELL_CreateInstance() 创建 IFileMgr 接口的实例。 调用IFILEMGR接口中的相应函数 获取有关应用程序目录中文件和目录的信息、文件系统中可用的空闲空间IFILEMGR_EnumInit() 、 IFILEMGR_EnumNext() 、 IFILEMGR_GetInfo() 、 IFILEMGR_GetFreeSpace() 创建和删除目录： IFILEMGR_MkDir()、IFILEMGR_RmDir() 打开创建、重命名或删除文件IFILEMGR_OpenFile()、IFILEMGR_Rename() 、 IFILEMGR_Remove() 。 如果要读/写文件的内容： 调用 IFILEMGR_OpenFile() 打开要读或写的文件。调用 IFile 接口中的函数访问文件内容。 访问结束后，调用 IFILE_Release() 关闭文件。 如果不再需要 IFileMgr 接口实例，则调用IFILEMGR_Release()释放接口实例。 需要的头文件： AEEFile.h IFileMgr 接口的函数 IFILEMGR_EnumInit() 和 IFILEMGR_EnumNext() 用于搜索指定的目录或文件 首先，调用 IFILEMGR_EnumInit() 设置要搜索的条件（文件和目录） 随后每次调用 IFILEMGR_EnumNext()，得到下一个符合条件的文件及其信息，如名称、大小、创建日期和属性。 搜索完所有指定的文件或目录后，IFILEMGR_EnumNext() 将返回 FALSE。 IFILEMGR_GetInfo() 获取指定文件或目录的信息，也可以通过调用 IFILE_GetInfo() 并输入其 IFile 实例指针来获取打开的文件的信息。 IFILEMGR_GetFreeSpace() 返回设备文件系统中可用的空闲字节数。 IFILEMGR_GetLastError() 返回 IFileMgr 函数最近检测到的错误（如果有）的错误代码。 通过该错误代码可以获取函数未能执行所请求任务的具体原因。错误码定义在AEEError.h中。 IFILEMGR_Test() 用于检查指定文件或目录是否存在。 IFileMgr 接口的函数 IFILEMGR_MkDir() 用于创建新目录，该目录通过与调用该函数的小程序目录相关的