sp_OADestroy (Transact-SQL)
Applies to: SQL Server
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
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for