IFX_UNLOAD_MODULE 函数

IFX_UNLOAD_MODULE 函数从共享内存卸载以 C 语言编写的 UDR 的共享对象文件。

参数	描述	限制	语法
module_name	要卸载文件的完整路径名	共享对象文件必须存在并且未被使用。路径名最大长度为 255 字节。	用引号括起的字符串

IFX_UNLOAD_MODULE 函数是所有者特权函数，其所有者是用户 gbasedbt。它返回的整数值表示共享对象文件卸载操作的状态：

IFX_UNLOAD_MODULE 函数只能卸载未使用的共享对象文件；也就是说，当没有执行的 SQL 语句（在任何数据库中）使用指定的共享对象文件中的任何 UDR 时。如果共享对象文件中的任何 UDR 当前正在使用，则 IFX_UNLOAD_MODULE 引发错误。

在 UNIX™ 上，例如，假设您希望卸载 circle.so 共享库，包含 C UDR。如果此库驻留在 /usr/apps/opaque_types 目录，可以使用以下 EXECUTE FUNCTION 语句执行 IFX_UNLOAD_MODULE 函数：

EXECUTE FUNCTION ifx_unload_module
        ("/usr/apps/opaque_types/circle.so", "C");

在 Windows™ 上，例如，假设希望卸载 circle.dll 动态链接库，包含 C UDR。如果该库在 C:\usr\apps\opaque_types 目录中，您可以使用以下 EXECUTE FUNCTION 语句执行 IFX_UNLOAD_MODULE 函数：

EXECUTE FUNCTION ifx_unload_module
        ("C:\usr\apps\opaque_types\circle.dll", "C");

有关如何使用 IFX_REPLACE_MODULE( ) 和 IFX_UNLOAD_MODULE( ) UDR 定义例程的更多信息，请参阅 GBase 8s 用户定义的例程和数据类型开发者指南和 GBase 8s DataBlade API 程序员指南。