ACIHandleAlloc()

ACIHandleAlloc()

作用：

返回指向已分配和初始化句柄的指针。

语法：

sword ACIHandleAlloc ( const void    *parenth,
                       void         **hndlpp,
                       ub4            type,
                       size_t         xtramem_sz,
                       void         **usrmempp );

参数：

• parenth (IN)

环境句柄。

• hndlpp (OUT)

返回的句柄。

• type (IN)

返回的句柄类型。

• xtramem_sz (IN)

ACI未使用。

• usrmempp (OUT)

ACI未使用。

说明：

返回指向已分配和初始化的句柄的指针，该指针与type中指定的类型相对应。 成功返回非NULL句柄。 相对于作为父句柄传入的环境句柄分配所有句柄。 错误无诊断可用。 如果成功，此调用将返回ACI_SUCCESS，如果发生错误，则返回ACI_INVALID_HANDLE。 必须先使用 ACIHandleAlloc 分配句柄，然后才能将它们传递到ACI调用中。