sp-oadestroy-transact-sql.md

title	sp_OADestroy (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	06/10/2016
ms.prod	sql
ms.prod_service	database-engine
ms.reviewer
ms.technology	system-objects
ms.topic	language-reference
f1_keywords	sp_OADestroy_TSQL sp_OADestroy
dev_langs	TSQL
helpviewer_keywords	sp_OADestroy
ms.assetid	0bd1cff4-ceff-4095-9ae4-e1e65a80f5d6
author	stevestein
ms.author	sstein

sp_OADestroy (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]

Destroys a created OLE object.

Transact-SQL Syntax Conventions

Syntax

  
sp_OADestroy objecttoken      

Arguments

objecttoken
Is the object token of an OLE object that was previously created by using sp_OACreate.

Return Code Values

0 (success) or a nonzero number (failure) that is the integer value of the HRESULT returned by the OLE Automation object.

For more information about HRESULT Return Codes, see OLE Automation Return Codes and Error Information.

Remarks

If sp_OADestroy is not called, the created OLE object is automatically destroyed at the end of the batch.

Permissions

Requires membership in the sysadmin fixed server role or execute permission directly on this Stored Procedure. Ole Automation Procedures configuration must be enabled to use any system procedure related to OLE Automation.

Examples

The following example destroys the previously created SQLServer object.

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

See Also

OLE Automation Stored Procedures (Transact-SQL)
OLE Automation Sample Script