Skip to content

Latest commit

 

History

History
127 lines (81 loc) · 3.64 KB

File metadata and controls

127 lines (81 loc) · 3.64 KB
description Learn more about: CSimpleRow Class
title CSimpleRow Class
ms.date 11/04/2016
f1_keywords
CSimpleRow
ATL::CSimpleRow
ATL.CSimpleRow
CSimpleRow::AddRefRow
AddRefRow
ATL.CSimpleRow.AddRefRow
ATL::CSimpleRow::AddRefRow
CSimpleRow.AddRefRow
CSimpleRow.Compare
CSimpleRow::Compare
ATL::CSimpleRow::CSimpleRow
CSimpleRow.CSimpleRow
ATL.CSimpleRow.CSimpleRow
CSimpleRow::CSimpleRow
ATL::CSimpleRow::ReleaseRow
CSimpleRow::ReleaseRow
ReleaseRow
CSimpleRow.ReleaseRow
ATL.CSimpleRow.ReleaseRow
CSimpleRow.m_dwRef
CSimpleRow::m_dwRef
CSimpleRow::m_iRowset
CSimpleRow.m_iRowset
helpviewer_keywords
CSimpleRow class
AddRefRow method
Compare method
CSimpleRow class, constructor
ReleaseRow method
m_dwRef
m_iRowset
ms.assetid 06d9621d-60cc-4508-8b0c-528d1b1a809b

CSimpleRow Class

Provides a default implementation for the row handle, which is used in the IRowsetImpl class.

Syntax

class CSimpleRow

Requirements

Header: atldb.h

Members

Methods

Name Description
AddRefRow Adds a reference count to an existing row handle.
Compare Compares two rows to see if they refer to the same row instance.
CSimpleRow The constructor.
ReleaseRow Releases rows.

Data Members

Name Description
m_dwRef Reference count to an existing row handle.
m_iRowset An index to the rowset representing the cursor.

Remarks

A row handle is logically a unique tag for a result row. IRowsetImpl creates a new CSimpleRow for every row requested in IRowsetImpl::GetNextRows. CSimpleRow can also be replaced with your own implementation of the row handle, as it is a default template argument to IRowsetImpl. The only requirement to replacing this class is to have the replacement class provide a constructor that accepts a single parameter of type LONG.

CSimpleRow::AddRefRow

Adds a reference count to an existing row handle in a thread-safe manner.

Syntax

DWORD AddRefRow();

CSimpleRow::Compare

Compares two rows to see if they refer to the same row instance.

Syntax

HRESULT Compare(CSimpleRow* pRow);

Parameters

pRow
A pointer to a CSimpleRow object.

Return Value

An HRESULT value, usually S_OK, indicating the two rows are the same row instance, or S_FALSE, indicating the two rows are different. See IRowsetIdentity::IsSameRow in the OLE DB Programmer's Reference for other possible return values.

CSimpleRow::CSimpleRow

The constructor.

Syntax

CSimpleRow(DBCOUNTITEM iRowsetCur);

Parameters

iRowsetCur
[in] Index to the current rowset.

Remarks

Sets m_iRowset to iRowsetCur.

CSimpleRow::ReleaseRow

Releases rows in a thread-safe manner.

Syntax

DWORD ReleaseRow();

CSimpleRow::m_dwRef

Reference count to an existing row handle.

Syntax

DWORD m_dwRef;

CSimpleRow::m_iRowset

Index to the rowset representing the cursor.

Syntax

KeyType m_iRowset;

See also

OLE DB Provider Templates
OLE DB Provider Template Architecture
IRowsetImpl Class