sp_addextendedproc (Transact-SQL)

新しい拡張ストアドプロシージャの名前を Microsoft SQL Server に登録します。

メモ :
この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。代わりに CLR Integration を使用してください。

構文

sp_addextendedproc [ @functname = ] 'procedure' , 
     [ @dllname = ] 'dll'

[ @functname = ] 'procedure'

ダイナミックリンクライブラリ (DLL) の内部で呼び出す関数の名前を指定します。procedure のデータ型は nvarchar(517) で、既定値はありません。procedure には、owner.function の形式で所有者名を含めることもできます。

[ @dllname = ] 'dll'

関数が含まれている DLL の名前を指定します。dll のデータ型は varchar(255) で、既定値はありません。DLL の完全パスを指定することをお勧めします。

なし

作成した拡張ストアドプロシージャは、sp_addextendedproc を使用して SQL Server に登録する必要があります。詳細については、「SQL Server への拡張ストアドプロシージャの追加」を参照してください。

このプロシージャは、master データベースでのみ実行できます。master データベース以外のデータベースから拡張ストアドプロシージャを実行するには、拡張ストアドプロシージャ名に master の修飾名を追加する必要があります。

sp_addextendedproc では、sys.objects カタログビューにエントリが追加され、新しい拡張ストアドプロシージャの名前が SQL Server に登録されます。また、sys.extended_procedures カタログビューにもエントリが追加されます。

重要 :
完全パスで登録されなかった既存の DLL は、SQL Server 2005 へのアップグレード後、機能しなくなります。この問題を修正するには、sp_dropextendedproc を使用して DLL の登録を解除し、sp_addextendedproc を使用して完全パスと共に登録し直します。

sp_addextendedproc を実行できるのは、sysadmin 固定サーバーロールのメンバだけです。

0 (成功) または 1 (失敗)

次の例では、xp_hello 拡張ストアドプロシージャを登録します。

USE master
GO
EXEC sp_addextendedproc xp_hello, 'c:\xp_hello.dll'