sp_OADestroy (Transact-SQL)
適用対象: SQL Server
作成された OLE オブジェクトを破棄します。
構文
sp_OADestroy objecttoken
[ ; ]
引数
objecttoken
sp_OACreate
を使用して以前に作成された OLE オブジェクトのオブジェクト トークン。
リターン コードの値
0
(成功) または 0 以外の数値 (失敗) は、OLE オートメーション オブジェクトによって返される HRESULT の整数値です。
HRESULT 戻りコードの詳細については、 OLE 自動化戻りコードとエラー情報を参照してください。
解説
sp_OADestroy
が呼び出されない場合、作成された OLE オブジェクトはバッチの最後に自動的に破棄されます。
アクセス許可
sysadmin固定サーバー ロールのメンバーシップが必要です。または、このストアド プロシージャに対して直接アクセス許可を実行します。 OLE オートメーションに関連するシステム プロシージャを使用するには、 Ole Automation Procedures サーバー構成オプションを有効にする必要があります。
例
次の例では、以前に作成した SQLServer
オブジェクトを破棄します。
EXEC @hr = sp_OADestroy @object;
IF @hr <> 0
BEGIN
EXEC sp_OAGetErrorInfo @object;
RETURN
END;