Releases the accessor rowset associated with the command.

void Close( );  

A command uses a rowset, result set accessor, and (optionally) a parameter accessor (unlike tables, which do not support parameters and do not need a parameter accessor).

When you execute a command, you should call both Close and ReleaseCommand after the command.

When you want to execute the same command repeatedly, you should release each result set accessor by calling Close before calling Execute. At the end of the series, you should release the parameter accessor by calling ReleaseCommand. Another common scenario is calling a stored procedure that has output parameters. On many providers (such as the OLE DB provider for SQL Server) the output parameter values will not be accessible until you close the result set accessor. Call Close to close the returned rowset and result set accessor, but not the parameter accessor, thus allowing you to retrieve the output parameter values.

The following example shows how you can call Close and ReleaseCommand when you execute the same command repeatedly.

[!code-cppNVC_OLEDB_Consumer#2]

Header: atldbcli.h

CCommand Class
CCommand::ReleaseCommand