Export (0) Print
Expand All

sp_OADestroy (Transact-SQL)

Destroys a created OLE object.

Applies to: SQL Server (SQL Server 2008 through current version).

Topic link icon Transact-SQL Syntax Conventions

sp_OADestroy objecttoken    

objecttoken

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

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.

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

Requires membership in the sysadmin fixed server role.

The following example destroys the previously created SQLServer object.

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

Community Additions

ADD
Show:
© 2014 Microsoft