sp_cursorclose (Transact-SQL)

Applies to: SQL Server

Closes and de-allocates the cursor, as well as releases all associated resources; that is, it drops the temporary table used in support of KEYSET or STATIC cursor. sp_cursorclose is invoked by specifying ID = 9 in a tabular data stream (TDS) packet.

Transact-SQL syntax conventions

Syntax

  
sp_cursorclose cursor  

Arguments

cursor
Is a cursor handle value generated by SQL Server and returned by the sp_cursoropen procedure. cursor is a required parameter that calls for an int input value.

Note

An input value of -1 will apply towards all cursors on the current connection.

Remarks

cursor will return error messages if the procedure was run after the cursor had been closed or if an invalid handle is specified.

RPC status indicates overall success or failure.

DONE rowcount is always 0.

See Also

sp_cursoropen (Transact-SQL)
System Stored Procedures (Transact-SQL)