sp_addextendedproc (Transact-SQL)

  • Articolo

Si applica a: SQL Server

Registra il nome di una nuova stored procedure estesa in SQL Server.

Nota

Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Usare invece l'integrazione CLR (Common Language Runtime).

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_addextendedproc
    [ @functname = ] N'functname'
    , [ @dllname = ] 'dllname'
[ ; ]

Argomenti

[ @functname = ] N'functname'

Nome della funzione da chiamare all'interno della libreria a collegamento dinamico (DLL). @functname è nvarchar(517), senza impostazione predefinita. @functname facoltativamente può includere il nome del proprietario nel formato <owner.function>.

[ @dllname = ] 'dllname'

Nome della DLL che contiene la funzione. @dllname è varchar(255), senza impostazione predefinita. Specificare il percorso completo della DLL.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Nessuno.

Osservazioni:

Dopo aver creato una stored procedure estesa, è necessario aggiungerla a SQL Server usando sp_addextendedproc. Per altre informazioni, vedere Aggiunta di una stored procedure estesa a SQL Server.

Questa procedura può essere eseguita solo nel master database. Per eseguire una stored procedure estesa da un database diverso masterda , qualificare il nome della stored procedure estesa con master.

sp_addextendedproc aggiunge voci alla vista del catalogo sys.objects , registrando il nome della nuova stored procedure estesa con SQL Server. Aggiunge anche una voce nella vista del catalogo sys.extended_procedures .

Importante

Le DLL esistenti non registrate con un percorso completo non funzionano dopo l'aggiornamento a SQL Server. Per risolvere il problema, usare sp_dropextendedproc per annullare la registrazione della DLL e quindi registrarla nuovamente con sp_addextendedproc, specificando il percorso completo.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_addextendedproc.

Esempi

Nell'esempio seguente viene aggiunta la xp_hello stored procedure estesa.

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

Contenuto correlato