ACIDescriptorAlloc ()

ACIDescriptorAlloc()

作用：

分配一个大字段、时间日期或时间间隔描述符句柄。在通过调用 ACIDefineByPos 函数绑定到此描述符以后，就可以通过该句柄进行读或写操作。

语法：

sword ACIDescriptorAlloc ( const void    *parenth,
                           void         **descpp,
                           ub4            type,
                           size_t         xtramem_sz,
                           void         **usrmempp);

参数：

• parenth (IN)

环境句柄。

• descpp (OUT)

返回一个描述符或者一个loblocator句柄。

• type (IN)

描述符的类型，描述符类型请参与《句柄管理》章节。

• xtramem_sz (IN)

ACI未使用。

• usrmempp (OUT)

ACI未使用。

说明：

返回指向已分配和初始化的描述符的指针，该描述符与type中指定的类型相对应。 成功返回非NULL描述符或LOB定位符。 错误无诊断可用。 如果成功，此调用将返回ACI_SUCCESS，如果发生内存不足错误，则返回ACI_INVALID_HANDLE。