ACILobLoadFromFile()

ACILobLoadFromFile()

作用：

从BFile中读取部分或者全部内容到lob中

语法：

sword ACILobLoadFromFile ( ACISvcCtx        *svchp,
                           ACIError         *errhp,
                           ACILobLocator    *dst_locp,
                           ACILobLocator    *src_locp,
                           ub4               amount,
                           ub4               dst_offset,
                           ub4               src_offset );

参数：

• svchp (IN)

服务上下文句柄

• errhp (IN/OUT)

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

• dst_locp (IN/OUT)

内部LOB的目标定位器，其类型可能是BLOB，CLOB。

• src_locp (IN)

源BFILE的定位器。

• amount (IN)

从src_locp的BFILE中要读取的字节数。

• dst_offset (IN)

这是目标LOB的绝对偏移量。 对于字符LOB，它是从LOB开头开始写入的字符数。对于二进制LOB，它是从LOB开头开始读取的字节数。 偏移量从1开始。

• src_offset (IN)

这是源BFILE的绝对偏移量。 它是从BFILE开头开始的字节数。 偏移量从1开始。

说明：

源（src_locp）和目标（dst_locp）LOB必须存在。如果数据存在于目的地的起始位置，则会被源数据覆盖。如果目标的起始位置超出了当前数据的末尾，则从数据末尾到新写入的数据的开头，将零字节填充符（对于BLOB）或空格（对于CLOB）写入目标LOB。如果目标LOB超出了目标LOB的当前长度，则将其扩展以容纳新写入的数据。

尝试从NULL BFILE复制是错误的。