sp_OADestroy (Transact-SQL)

Se aplica a:SQL Server

Destruye un objeto OLE creado.

Convenciones de sintaxis de Transact-SQL

Sintaxis

  
sp_OADestroy objecttoken      

Argumentos

objecttoken
Es el token de objeto de un objeto OLE que se creó anteriormente mediante sp_OACreate.

Valores de código de retorno

0 (correcto) o un valor distinto de cero (error) que es el valor entero del HRESULT devuelto por el objeto de OLE Automation.

Para obtener más información sobre los códigos de retorno HRESULT, vea Códigos de retorno y información de error de OLE Automation.

Comentarios

Si no se llama a sp_OADestroy , el objeto OLE creado se destruye automáticamente al final del lote.

Permisos

Requiere la pertenencia al rol fijo de servidor sysadmin o ejecutar el permiso directamente en este procedimiento almacenado. Ole Automation Procedures la configuración debe estar habilitada para usar cualquier procedimiento del sistema relacionado con OLE Automation.

Ejemplos

En el ejemplo siguiente se destruye el objeto SQLServer creado anteriormente.

EXEC @hr = sp_OADestroy @object;  
IF @hr <> 0  
BEGIN  
   EXEC sp_OAGetErrorInfo @object  
    RETURN  
END;  

Consulte también

Procedimientos almacenados de OLE Automation (Transact-SQL)
Ejemplo de script de automatización OLE