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 将连接归还给池。