sp_OADestroy
Destroys a created OLE object.
Syntax
sp_OADestroy objecttoken
Arguments
objecttoken
Is the object token of an OLE object previously created by 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
Only members of the sysadmin fixed server role can execute sp_OADestroy.
Examples
This example destroys the previously created SQLServer object.
EXEC @hr = sp_OADestroy @object
IF @hr <> 0
BEGIN
EXEC sp_OAGetErrorInfo @object
RETURN
END
See Also
Data Type Conversions Using OLE Automation Stored Procedures
How to create an OLE Automation object (Transact-SQL)