ACIServerRelease2()

ACIServerRelease2()

作用：

返回数据库发行字符串。

语法：

sword ACIServerRelease2( void         *hndlp,
                         ACIError     *errhp,
                         OraText      *bufp,
                         ub4           bufsz,
                         ub1           hndltype,
                         ub4          *versionp,
                         ub4           mode);

参数：

• hndlp (IN)

服务上下文句柄或服务器上下文句柄。

• errhp (IN/OUT)

当发生错误时，可以将其传递给 ACIErrorGet 以获得诊断信息的错误句柄。

• bufp (IN/OUT)

返回释放字符串的缓冲区。

• bufsz (IN)

缓冲区的长度（以字节数为单位）。

• hndltype (IN)

传递给函数的句柄类型。

• versionp (IN/OUT)

整数形式的发布字符串。

• mode (IN)

有效值为ACI_SRVRELEASE2_CACHED和ACI_DEFAULT。

如果该模式以ACI_SRVRELEASE2_CACHED的形式提供，则返回服务器版本的缓存版本（如果可用）。这样可以节省往返如果应用程序调用该函数不止一次。在这种模式下，应用程序可以选择提供一个空bufp。在这样的情况下，仅versionp参数被填充。ACI_DEFAULT每次都会到数据库端查询。

说明：

缓冲区指针bufp以字符串表示形式指向释放信息，该字符串表示形式直至bufsz（包括NULL终止符）。 如果缓冲区大小太小，结果将被截断为大小bufsz。 version参数包含5位整数形式的数据库发行字符串，可以使用以下宏来检索该字符串：

ACI_SERVER_RELEASE_REL(v)
           /* old: version number */
           /* new: feature release */
ACI_SERVER_RELEASE_REL_UPD(v)
            /* old: release number */
            /* new: release update */
ACI_SERVER_RELEASE_REL_UPD_REV(v)
           /* old: update number */
           /* new: release update revision */
ACI_SERVER_RELEASE_REL_UPD_INC(v)
          /* old: porting release number */
          /* new: release update increment */
ACI_SERVER_RELEASE_EXT(v)
       /* old: porting update number */
       /* new: extension */