CAccessorRowset Class

Encapsulates a rowset and its associated accessors in a single class.

Syntax

template <class TAccessor = CNoAccessor,
   template <typename T> class TRowset = CRowset>
class CAccessorRowset : public TAccessor, public TRowset<TAccessor>

Parameters

TAccessor
An accessor class.

TRowset
A rowset class.

Requirements

Header: atldbcli.h

Members

Methods

Name	Description
Bind	Creates bindings (used when bBind is specified as false in CCommand::Open).
CAccessorRowset	Constructor.
Close	Closes the rowset and any accessors.
FreeRecordMemory	Frees any columns in the current record that need to be freed.
GetColumnInfo	Implements IColumnsInfo::GetColumnInfo.

Remarks

Class TAccessor manages the accessor. Class TRowset manages the rowset.

CAccessorRowset::Bind

Creates the bindings if you specified bBind as false in CCommand::Open.

Syntax

HRESULT Bind();

Return Value

A standard HRESULT.

CAccessorRowset::CAccessorRowset

Initializes the CAccessorRowset object.

Syntax

CAccessorRowset();

CAccessorRowset::Close

Releases any active accessors and the rowset.

Syntax

void Close();

Remarks

Releases any associated memory.

CAccessorRowset::FreeRecordMemory

Frees any columns in the current record that need to be freed.

Syntax

void FreeRecordMemory();

CAccessorRowset::GetColumnInfo

Gets column information from the opened rowset.

Syntax

HRESULT GetColumnInfo(DBORDINAL* pulColumns,
   DBCOLUMNINFO** ppColumnInfo,
   LPOLESTR* ppStrings) const;

HRESULT GetColumnInfo(DBORDINAL* pColumns,
   DBCOLUMNINFO** ppColumnInfo);

Parameters

See IColumnsInfo::GetColumnInfo in the OLE DB Programmer's Reference.

Return Value

A standard HRESULT.

Remarks

The user must free the returned column information and string buffer. Use the second version of this method when you use CDynamicAccessor and need to override the bindings.

For more information, see IColumnsInfo::GetColumnInfo in the OLE DB Programmer's Reference.

See also

OLE DB Consumer Templates
OLE DB Consumer Templates Reference