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 オートメーションのサンプル スクリプト