ACIDirPathPrepare()

ACIDirPathPrepare()

作用:

在任何行都能被转换或加载之前准备直接路径加载接口

语法:

sword ACIDirPathPrepare ( ACIDirPathCtx          *dpctx,
                          ACISvcCtx              *svchp,
                          ACIError               *errhp );

参数:

  • dpctx (IN)

所加载对象的直接路径上下文句柄。

  • svchp (IN)

服务上下文句柄

  • errhp (IN/OUT)

错误句柄,该接口调用失败时,错误信息会存在该句柄上 ,调用 ACIErrorGet 获得错误信息。

说明:

在设置要操作的对象的名称,设置列数据的外部属性以及设置所有加载选项之后,必须先使用 ACIDirPathPrepare 准备直接路径接口,然后才能转换或加载任何行。

ACI_SUCCESS的返回值表示后端已经为直接路径加载操作正确初始化。 非零返回值表示错误。 可能的错误是:

  • 无效的上下文
  • 未连接到服务器
  • 未设置对象名称
  • 已经准备好(无法准备两次)
  • 对象不适合直接路径操作