ACIDirPathLoadStream()

ACIDirPathLoadStream()

作用：

加载转换为直接路径流格式的数据。

语法：

sword ACIDirPathLoadStream (   ACIDirPathCtx          *dpctx,
                               ACIDirPathStream       *dpstr,
                               ACIError               *errhp );

参数：

• dpctx (IN)

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

• dpstr (IN)

用于加载流的直接路径流句柄。

• errhp (IN/OUT)

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

说明：

当接口返回错误时，可以获取与源流的列数组中的行有关的信息作为直接路径流的属性。另外，可以获得发生错误的流中的偏移作为流的属性。

该函数的返回码为：

ACI_SUCCESS-流中的所有数据已成功加载。

ACI_ERROR-加载数据时发生错误。问题可能是分区映射错误，违反NULL约束，基于函数的索引评估错误或空间不足（例如无法分配范围）等。 ACI_ATTR_ROW_COUNT是在上一次调用中成功加载的行数。

ACI_NEED_DATA-最后一行未完成，不是一行完整的数据。调用者必须提供其他行的数据片，让行数据完整。如果流是从列数组中获取的，则属性ACI_ATTR_ROW_COUNT是在上一次调用中成功加载的完整行数。

ACI_NO_DATA-尝试加载空流或已完全处理的流。

必须重复加载流，直到返回ACI_SUCCESS，ACI_NEED_DATA或ACI_NO_DATA。例如，如果从 ACIDirPathLoadStream 返回ACI_ERROR，则无法重置流。