DBCC dllname (FREE) (Transact-SQL)

Unloads the specified extended stored procedure DLL from memory.

Topic link iconTransact-SQL Syntax Conventions

Syntax

DBCC dllname ( FREE ) [ WITH NO_INFOMSGS ]

Arguments

  • dllname
    Is the name of the DLL to release from memory.
  • WITH NO_INFOMSGS
    Suppresses all informational messages.

Result Sets

When a valid DLL is specified, DBCC dllname (FREE) returns:

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

Remarks

When an extended stored procedure is executed, the DLL remains loaded by the instance of Microsoft SQL Server 2005 until the server is shut down. This statement allows for a DLL to be unloaded from memory without shutting down SQL Server. To display the DLL files currently loaded by SQL Server, execute sp_helpextendedproc

Permissions

Requires membership in the sysadmin fixed server role or the db_owner fixed database role.

Examples

The following example assumes that xp_sample is implemented as Xp_sample.dll and has been executed. DBCC dllname (FREE) unloads the Xp_sample.dll file associated with the xp_sample extended procedure.

DBCC xp_sample (FREE);

See Also

Reference

DBCC (Transact-SQL)
sp_addextendedproc (Transact-SQL)
sp_dropextendedproc (Transact-SQL)
sp_helpextendedproc (Transact-SQL)

Other Resources

Execution Characteristics of Extended Stored Procedures
Unloading an Extended Stored Procedure DLL

Help and Information

Getting SQL Server 2005 Assistance