sp_OADestroy (Transact-SQL)

适用范围:SQL Server

破坏已创建的 OLE 对象。

Transact-SQL 语法约定

语法

sp_OADestroy objecttoken
[ ; ]

参数

objecttoken

以前使用 sp_OACreate 创建的 OLE 对象的对象标记。

返回代码值

0 (success) 或非零数 (failure) 是 OLE 自动化对象返回的 HRESULT 的整数值。

有关 HRESULT 返回代码的详细信息,请参阅 OLE 自动化返回代码和错误信息

注解

如果未 sp_OADestroy 调用,则创建的 OLE 对象会在批处理结束时自动销毁。

权限

需要 sysadmin 固定服务器角色的成员身份或直接在此存储过程上执行权限。 必须启用 Ole Automation Procedures 服务器配置选项,才能使用与 OLE 自动化相关的任何系统过程。

示例

以下示例销毁以前创建 SQLServer 的对象。

EXEC @hr = sp_OADestroy @object;

IF @hr <> 0
BEGIN
    EXEC sp_OAGetErrorInfo @object;

    RETURN
END;