sp_OADestroy (Transact-SQL)

適用対象: SQL Server

作成された OLE オブジェクトを破棄します。

Transact-SQL 構文表記規則

構文

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;