dsmRegisterFS

在线编辑

dsmRegisterFS 函数调用向 IBM® Storage Protect 服务器注册新的文件空间。 在将任何数据备份到文件空间前，请先注册该文件空间。

应用程序客户机不应与备份/归档客户机使用相同的文件空间。

  • 在 UNIX 或 Linux®上，对这些名称运行 df 命令。
  • 在 Windows 上，这些名称通常是与系统上的不同驱动器相关联的卷标。

语法

dsInt16_t dsmRegisterFS  (dsUint32_t         dsmHandle,
   regFSData     *regFilespaceP);

参数

dsUint32_t dsmHandle (I)
将此调用与之前的 dsmInitEx 调用相关联的句柄。
regFSData *regFilespaceP (I)
此参数传递需要向 IBM Storage Protect 服务器注册的文件空间的名称和关联信息。
提示: fstype 字段包含前缀 API:。 所有文件空间查询均显示此字符串。 例如，如果用户在 dsmRegisterFS中针对 fstype 传递 myfstype ， 查询时，服务器上的实际值字符串将返回为 API:myfstype 。 此前缀可区分 API 对象和备份/归档对象。

fsInfo 的可用区域现在为 DSM_MAX_USER_FSINFO_LENGTH。

返回码

返回码编号用括号 ( ) 括起。

表 1. 返回代码为 dsmRegisterFS
返回码 说明
DSM_RC_INVALID_FSNAME (2016) 无效的文件空间名称。
DSM_RC_INVALID_DRIVE_CHAR (2026) 盘符不是字母字符。
DSM_RC_NULL_FSNAME (2027) Null 文件空间名称。
DSM_RC_FS_ALREADY_REGED (2062) 文件空间已注册。
DSM_RC_WRONG_VERSION_PARM (2065) 应用程序客户机的 API 版本与 IBM Storage Protect 库版本不同。
DSM_RC_FSINFO_TOOLONG (2106) 文件空间信息过长。