sp_OADestroy (Transact-SQL)

適用於:SQL Server

終結已建立的 OLE 物件。

Transact-SQL 語法慣例

語法

  
sp_OADestroy objecttoken      

引數

objecttoken
這是先前使用 sp_OACreate 建立之 OLE 對象的物件標記。

傳回碼值

0 (success) 或非零數位 (failure),這是 OLE Automation 物件所傳回之 HRESULT 的整數值。

如需 HRESULT 傳回碼的詳細資訊,請參閱 OLE Automation 傳回碼和錯誤資訊

備註

如果未 呼叫sp_OADestroy ,則建立的 OLE 物件會在批次結尾自動終結。

權限

需要系統管理員固定伺服器角色的成員資格,或直接在此預存程式上執行許可權。 Ole Automation Procedures 必須 啟用 組態,才能使用任何與 OLE Automation 相關的系統程式。

範例

下列範例會終結先前建立 的 SQLServer 物件。

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

另請參閱

OLE Automation 預存程序 (Transact-SQL)
OLE 自動化範例腳本