/****************************************************************************/ /* Copyright (c) 2007,许继集团有限公司 */ /* All rights reserved. */ /* */ /* 模块描述: */ /** 文件服务模块 * @file ac_file.h */ /* */ /* 日期 作者 注释 */ /* 2007/10/09 ljg 创建文件 */ /****************************************************************************/ #ifndef IEC61850_AC_FILE_H #define IEC61850_AC_FILE_H #include "glbtypes.h" #include "gen_list.h" #include "ac_reqm.h" #ifdef __cplusplus extern "C" { #endif /** 读文件服务请求所需信息结构定义*/ typedef struct { ST_CHAR *src_fname; /**< 读取的远方服务器中的文件名,可带路径 */ ST_CHAR *dest_fname; /**< 存到本地时用的名字 */ U_AC_REQ_DONE u_getf_done; /**< 用户回调 */ }AC_GETF_REQ_INFO; /** 写文件服务请求所需信息结构定义*/ typedef struct { ST_CHAR *src_fname; /**< 本地文件系统中要写到服务器的文件,可带路径 */ ST_CHAR *dest_fname; /**< 存到服务器文件系统中用的名字 */ U_AC_REQ_DONE u_setf_done; /**< 用户回调 */ }AC_SETF_REQ_INFO; /** 获得文件列表服务请求所需信息结构定义*/ typedef struct { ST_CHAR *file_name; /**< 请求的文件名或目录名 */ U_AC_REQ_DONE u_getf_done; /**< 用户回调 */ }AC_GETFAV_REQ_INFO; /** 删除文件服务请求所需信息结构定义*/ typedef struct { ST_CHAR *file_name; /**< 要删除的服务器的文件,可带路径 */ U_AC_REQ_DONE u_getf_done; /**< 用户回调 */ }AC_DELF_REQ_INFO; /** * 从服务器读取一个文件存到本地 * @param srv_id 服务器id * @param src_fname 读取的文件名,可带路径 * @param dest_fname 存到本地时用的名字 * @param time_out 请求超时时间,如果time_out时间内文件没有传完则认为请求失败 * @param req_ctrl_out 传出的请求控制结构 */ ST_RET ac_get_file(ST_INT srv_id, AC_GETF_REQ_INFO *getf_info, ST_INT time_out, AC_REQ_CTRL **req_ctrl_out); /** * 发送读文件服务接口,请求已从链表中取出 * @param req_ctrl 请求结构 * @retval SD_SUCCESS 发送成功 * @retval SD_FAILURE 发送失败 */ ST_RET ac_send_getfile_req(AC_REQ_CTRL * req_ctrl ); /** * 将本地的一个文件写到服务器中 * @param srv_id 服务器id * @param setf_info 写文件请求信息 * @param time_out 请求超时时间,如果time_out时间内文件没有传完则认为请求失败 * @param req_ctrl_out 传出的请求控制结构 */ ST_RET ac_set_file(ST_INT srv_id, AC_SETF_REQ_INFO *setf_info, ST_INT time_out, AC_REQ_CTRL **req_ctrl_out); /** * 发送写文件服务接口,请求已从链表中取出 * @param req_ctrl 请求结构 * @retval SD_SUCCESS 发送成功 * @retval SD_FAILURE 发送失败 */ ST_RET ac_send_setfile_req(AC_REQ_CTRL * req_ctrl ); /** * 读取某个文件的属性或目录下的所有文件的属性 * @param srv_id 服务器id * @param getfav_info 读文件属性请求信息 * @param time_out 请求超时时间 * @param req_ctrl_out 传出的请求控制结构 */ ST_RET ac_get_file_attr(ST_INT srv_id, AC_GETFAV_REQ_INFO *getfav_info, ST_INT time_out, AC_REQ_CTRL **req_ctrl_out); /** * 发送读文件属性服务接口,请求已从链表中取出 * @param req_ctrl 请求结构 * @retval SD_SUCCESS 发送成功 * @retval SD_FAILURE 发送失败 */ ST_RET ac_send_getfav_req(AC_REQ_CTRL * req_ctrl ); /** * 释放AC_GETFAV_REQ_CTRL结构成员所占资源 * obj_vals、results成员资源 * @param reqCtrl 请求结构指针 * @return ST_VOID */ ST_VOID ac_cleanup_getFavReqCtrl(AC_GETFAV_REQ_CTRL *reqCtrl); /** * 删除文件请求 * @param srv_id 服务器id * @param delf_info 删除文件请求信息 * @param time_out 请求超时时间 * @param req_ctrl_out 传出的请求控制结构 */ ST_RET ac_delete_file(ST_INT srv_id, AC_DELF_REQ_INFO *delf_info, ST_INT time_out, AC_REQ_CTRL **req_ctrl_out); /** * 发送删除文件服务接口,请求已从链表中取出 * @param req_ctrl 请求结构 * @retval SD_SUCCESS 发送成功 * @retval SD_FAILURE 发送失败 */ ST_RET ac_send_delfile_req(AC_REQ_CTRL * req_ctrl ); #ifdef __cplusplus } #endif #endif /** IEC61850_AC_file_H */