sp_OADestroy (Transact-SQL)

適用範圍: 是SQL Server (所有支援的版本)

損毀已建立的 OLE 物件。

主題連結圖示 Transact-SQL 語法慣例

語法

  
sp_OADestroy objecttoken      

引數

objecttoken
這是先前使用 sp_OACreate 所建立之 OLE 物件的物件 token。

傳回碼值

0 (成功) 或非零數字 (失敗),這個數字是 OLE Automation 物件所傳回之 HRESULT 的整數值。

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

備註

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

權限

需要 系統管理員(sysadmin )固定伺服器角色中的成員資格,或直接在此預存程式上執行許可權。 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 Automation 範例指令碼