Share via

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 Automation Procedures OLE オートメーションに 関連するシステム プロシージャを使用するには、構成を有効にする 必要があります。

例

次の例では、以前に作成 した SQLServer オブジェクトを 破棄します。

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

参照

OLE オートメーション ストアド プロシージャ (Transact-SQL)
OLE オートメーションのサンプル スクリプト