ACILobFileGetName()

ACILobFileGetName()

作用：

获取当前bfile描述符的目录对象和文件名。

语法：

sword ACILobFileGetName ( ACIEnv                   *envhp,
                          ACIError                 *errhp,
                          const ACILobLocator      *filep,
                          OraText                  *dir_alias,
                          ub2                      *d_length,
                          OraText                  *filename,
                          ub2                      *f_length );

参数：

• envhp(IN/OUT)

环境句柄

• errhp (IN/OUT)

错误句柄，该接口调用失败时，错误信息会存在该句柄上 ，调用 ACIErrorGet 获得错误信息。

• filep (IN/OUT)

存贮BFILE描述符指针

• dir_alias (OUT)

目录对象名称所在的缓冲区。 可以是UTF-16字符集。 您必须为目录对象名称分配足够的空间。 目录对象的最大长度为30个字节。

• d_length (IN/OUT)

有以下用途（可以在Unicode的代码点或字节中）：

IN：输入的dir_alias字符串的长度

OUT：返回的dir_alias字符串的长度

• filename (OUT)

文件名所在的缓冲区。 您必须为文件名分配足够的空间。 文件名的最大长度为255个字节。

• f_length (IN/OUT)

filename的大小

具有以下用途（以字节数为单位）：

IN：输入文件名缓冲区的长度

OUT：返回的文件名字符串的长度

说明：

只适用BFILE类型，其他LOB类型不行。