IRowsetInfoImpl Class

Provides an implementation for the IRowsetInfo interface.

Syntax

template <class T, class PropClass = T>
class ATL_NO_VTABLE IRowsetInfoImpl :
   public IRowsetInfo,
   public CUtlProps<PropClass>

Parameters

T
Your class, derived from IRowsetInfoImpl.

PropClass
A user-definable property class that defaults to T.

Requirements

Header: altdb.h

Members

Interface Methods

Name Description
GetProperties Returns the current settings of all properties supported by the rowset.
GetReferencedRowset Returns an interface pointer to the rowset to which a bookmark applies.
GetSpecification Returns an interface pointer on the object (command or session) that created this rowset.

Remarks

A mandatory interface on rowsets. This class implements the rowset properties by using the property set map defined in your command class. Although the rowset class appears to be using the command class' property sets, the rowset is supplied with its own copy of the run-time properties, when it is created by a command or session object.

IRowsetInfoImpl::GetProperties

Returns the current settings for properties in the DBPROPSET_ROWSET group.

Syntax

STDMETHOD (GetProperties )(const ULONG cPropertyIDSets,
   const DBPROPIDSET rgPropertyIDSets[],
   ULONG* pcPropertySets,
   DBPROPSET** prgPropertySets);

Parameters

See IRowsetInfo::GetProperties in the OLE DB Programmer's Reference.

IRowsetInfoImpl::GetReferencedRowset

Returns an interface pointer to the rowset to which a bookmark applies.

Syntax

STDMETHOD (GetReferencedRowset )(DBORDINAL iOrdinal,
   REFIID riid,
   IUnknown** ppReferencedRowset);

Parameters

See IRowsetInfo::GetReferencedRowset in the OLE DB Programmer's Reference. The iOrdinal parameter must be a bookmark column.

IRowsetInfoImpl::GetSpecification

Returns an interface pointer on the object (command or session) that created this rowset.

Syntax

STDMETHOD (GetSpecification )(REFIID riid,
   IUnknown** ppSpecification);

Parameters

See IRowsetInfo::GetSpecification in the OLE DB Programmer's Reference.

Remarks

Use this method with IGetDataSourceImpl to retrieve properties from the data source object.

See also

OLE DB Provider Templates
OLE DB Provider Template Architecture