ACISessionPoolDestroy()¶
-
ACISessionPoolDestroy()¶
作用:
销毁一个初始化后的会话池。
语法:
sword ACISessionPoolDestroy ( ACISPool *spoolhp,
ACIError *errhp,
ub4 mode );
参数:
- spoolhp (IN/OUT)
已初始化的会话池句柄的指针。
- errhp (IN/OUT)
错误句柄,该接口调用失败时,错误信息会存在该句柄上,调用 ACIErrorGet 获得错误信息。
- mode (IN)
- ACI_DEFAULT-用于销毁会话池,此时如果池中有繁忙的会话,则会返回错误。
- ACI_SPD_FORCE-如果在模式设置为ACI_SPD_FORCE的情况下进行此调用,将强制关闭繁忙且未回池的会话,并销毁该池。使用此模式进行调用之后,不能再调用
ACISessionRelease释放会话。
- ACI_SPD_DRAIN -如果使用ACI_SPD_DRAIN模式进行此调用,并且池中有活动会话,则应用程序将等待指定的超时时间,然后关闭会话并销毁该池。使用此模式进行调用之后,不能再调用
ACISessionRelease释放会话。等待超时时间由会话池的ACI_SPD_DRAIN属性设置,目前ACI不支持。
说明:
调用此函数前,建议将从池中获取的会话先进行事务处理(提交或者回滚)并调用 ACISessionRelease 将连接归还给池。