24.5 VBA接口

以下为客户端vba调用网盘功能的接口函数

通用：

所有vba接口函数参数中的”远程目录"或“远程文件标识符”表示方法为：

远程目录:=<已注册的根目录名>[\<物理子目录名>]

远程文件标识符:=<已注册的根目录名>[\<物理子目录名>]\<物理文件名>

NFS_OpenDisk

功能：打开网络硬盘操作窗口，用户可在其中自由操作，关闭窗口，函数返回。其效果等同于点击菜单【报表】--【网络硬盘】

参数：两个返回参数：op，用户在窗口中进行过的所有操作的记录，是xml格式的串。errMsg，出错信息。

NFS_listRemoteDir

功能：列举当前用户有权限的所有远程目录。

返回值：字符型，当前用户有权限的所有远程目录连成的串，彼此间用"|"分隔。

参数：
readable，boolean型，可读=下载|列举
writeable，Boolean型，可写=建目录|删目录|目录更名|上载文件|删文件|文件更名

NFS_uploadFolder

功能：上传本地目录(包括其中的子目录及文件)到指定的远程目录中，称为其中的一个子目录。如果指定的远程目录下存在同名的子目录或文件，覆盖之。

返回值：Boolean型，true表示成功，false表示失败

参数：
localDir：string，本机目录名
remoteDir：string，远程目录
errMsg：string，返回参数。如果出错，为错误信息。

要求：
远程目录要存在
当前用户对远程目录拥有以下权限：建目录，上载文件，修改文件

NFS_uploadFile

功能：上传本地文件到指定的远程目录。如果远程目录不存在（至少第一级要存在），创建之；如果远程目录下同名文件存在，覆盖之。

返回值：Boolean型。true表示成功，false表示失败。

参数：
localFile：string，本地文件标识符
remoteDir：string，远程目录
errMsg：string，返回参数。如果出错，为错误信息。

要求：
指定的远程目录至少第一级存在。
如果远程目录本身存在，要求当前用户对其有写文件的权限；如果远程目录本身不存在，但是其某一级父目录存在，要求当前用户对其有创建子目录和写文件的权限。

NFS_downloadFolder

功能：下载远程目录（及其下的全部子目录和文件）到本机指定目录中，成为其中的一个子目录。如果同名目录（或其子目录）已存在，覆盖其中的同名文件。

返回值：Booelan型。true表示成功，false表示失败

参数：
remoteFolder：string，远程目录名
localDir：String，本地目录。
errMsg：string，返回参数。如果出错为错误信息

要求：
当前用户对远程目录有下载权限

NFS_downloadFile

功能：下载文件到本机指定目录中，可能改名。如果同名文件存在，覆盖之。

返回值：Boolean型。true表示成功，false表示失败

参数：
remoteFile：string，远程文件标识符。
localDir：Strinng，本地目录，远程文件将下载到此目录中。
newFileName：文件下载后重命名，此参数可选，若为空，表示不更名。
errMsg：string，返回参数。如果出错为错误信息。

要求：当前用户对远程目录有下载权限。

NFS_createRemoteFolder

功能：在远程目录中创建子目录。

返回值：Boolean型，true表示成功，false表示失败

参数：
remoteDir：要创建的远程目录。若此目录本身存在，则什么也不用做。否则，沿此目录向上，找到其最低一级子目录，在其中依次创建出各级，直至remoteDir被创建出来。