sp_xml_removedocument (Transact-SQL)

Removes the internal representation of the XML document specified by the document handle and invalidates the document handle.

Note

A parsed document is stored in the internal cache of SQL Server. The MSXML parser (Msxmlsql.dll) uses one-eighth the total memory available for SQL Server. To avoid running out of memory, run sp_xml_removedocument to free up the memory.

Topic link iconTransact-SQL Syntax Conventions

Syntax

sp_xml_removedocument hdoc

Arguments

  • hdoc
    Is the handle to the newly created document. A handle that is not valid returns an error. hdoc is an integer.

Return Code Values

0 (success) or >0 (failure)

Permissions

Requires membership in the public role.

Examples

The following example removes the internal representation of an XML document. The handle to the document is provided as input.

EXEC sp_xml_removedocument @hdoc