適用於:SQL Server
終結已建立的 OLE 物件。
語法
sp_OADestroy objecttoken
[ ; ]
引數
重要
擴充預存程式的自變數必須依特定順序輸入,如 語法 一節所述。 如果參數依序輸入,就會發生錯誤訊息。
objecttoken
先前使用 sp_OACreate所建立之 OLE 物件的物件標記。
傳回碼值
0 (success) 或非零數位 (failure),這是 OLE Automation 物件所傳回之 HRESULT 的整數值。
如需 HRESULT 傳回碼的詳細資訊,請參閱 OLE 自動化傳回碼和錯誤資訊。
備註
如果未 sp_OADestroy 呼叫,則建立的 OLE 物件會在批次結尾自動終結。
權限
需要系統管理員固定伺服器角色的成員資格,或直接在此預存程式上執行許可權。 必須啟用 [Ole Automation Procedures] 伺服器組態選項,才能使用任何與 OLE Automation 相關的系統程式。
範例
下列範例會終結先前建立 SQLServer 的物件。
EXECUTE
@hr = sp_OADestroy
@object;
IF @hr <> 0
BEGIN
EXECUTE sp_OAGetErrorInfo @object;
RETURN;
END