DBCC dllname (FREE) (Transact-SQL)

Artigo
03/07/2014

Descarrega o procedimento armazenado estendido DLL especificado da memória.

Aplica-se a: SQL Server (SQL Server 2008 à versão atual).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

DBCC dllname ( FREE ) [ WITH NO_INFOMSGS ]

Argumentos

dllname
É o nome do DLL para libertar da memória.
WITH NO_INFOMSGS
Suprime todas as mensagens informativas.

Comentários

Quando um procedimento armazenado estendido é executado, o DLL permanece carregado pela instância do SQL Server até que o servidor seja desativado. Esta instrução permite a um DLL ser descarregado da memória sem desativar o SQL Server. Para exibir os arquivos DLL carregados pelo SQL Serveratualmente, execute sp_helpextendedproc

Conjuntos de resultados

Quando um DLL válido é especificado, o DBCC dllname (FREE) retorna:

DBCC execution completed. If DBCC printed error messages, contact your system administrator.

Permissões

Requer associação na função de servidor fixa sysadmin ou na função de banco de dados fixa db_owner.

Exemplos

O exemplo a seguir assume que xp_sample está implementado como Xp_sample.dll, e foi executado. O dllname de DBCC (FREE) descarrega o arquivo Xp_sample.dll, associado com o procedimento estendido xp_sample.