sp-invalidate-textptr-transact-sql.md

title	sp_invalidate_textptr (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/14/2017
ms.prod	sql-non-specified
ms.reviewer
ms.suite
ms.technology	database-engine
ms.tgt_pltfrm
ms.topic	language-reference
f1_keywords	sp_invalidate_textptr_TSQL sp_invalidate_textptr
dev_langs	TSQL
helpviewer_keywords	sp_invalidate_textptr
ms.assetid	dd9920e1-7064-4c05-93d8-9303103fa1d6
caps.latest.revision	29
author	BYHAM
ms.author	rickbyh
manager	jhubbard

sp_invalidate_textptr (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx_md]

Invalidates the specified in-row text pointer, or all in-row text pointers, in the transaction. sp_invalidate_textptr can be used only on in-row text pointers. These pointers are from tables that have the text in row option enabled.

Applies to: [!INCLUDEssNoVersion] ([!INCLUDEssKatmai] through current version).

Transact-SQL Syntax Conventions

Syntax

  
sp_invalidate_textptr [ [ @TextPtrValue = ] textptr_value ]  

Arguments

[ @TextPtrValue= ] textptr_value
Is the in-row text pointer that to be invalidated. textptr_value is varbinary(16), with a default of NULL. If NULL, sp_invalidate_textptr invalidates all in-row text pointers in the transaction.

Return Code Values

0 (success) or 1 (failure)

Remarks

[!INCLUDEssNoVersion] allows for a maximum of 1,024 active valid in-row text pointers per transaction per database; however, a transaction spanning more than one database can have 1,024 in-row text pointers in each database. sp_invalidate_textptr can be used to invalidate in-row text pointers and, therefore, free space for additional in-row text pointers.

For more information about the text in row option, see sp_tableoption (Transact-SQL).

Permissions

Requires membership in the public role.

See Also

Database Engine Stored Procedures (Transact-SQL)
System Stored Procedures (Transact-SQL)
sp_tableoption (Transact-SQL)
TEXTPTR (Transact-SQL)
TEXTVALID (Transact-SQL)