Skip to content

Latest commit

 

History

History
38 lines (29 loc) · 2.02 KB

fetching-a-single-row-with-irow.md

File metadata and controls

38 lines (29 loc) · 2.02 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic helpviewer_keywords
Fetch single row with IRow (Native Client OLE DB provider)
Fetching a Single Row with IRow (Native Client OLE DB Provider)
markingmyname
maghan
03/14/2017
sql
native-client
reference
fetching rows
IRow interface
single row fetching [SQL Server Native Client]
OLE DB rowsets, fetching
rowsets [OLE DB], fetching
SQL Server Native Client OLE DB provider, fetching

Fetching a Single Row with IRow (Native Client OLE DB Provider)

[!INCLUDESQL Server Azure SQL Database Synapse Analytics PDW]

The IRow interface implementation in the [!INCLUDEssNoVersion] Native Client OLE DB provider is simplified to increase performance. IRow allows direct access to columns of a single row object. If you know beforehand that the result of a command execution will produce exactly one row, IRow will retrieve the columns of that row. If the result set includes multiple rows, IRow will expose only the first row.

The IRow implementation does not allow any navigation of the row. Each column in the row is accessed only one time with one exception: A column can be accessed one time to find the column size and again to fetch the data.

Note

IRow::Open supports only DBGUID_STREAM and DBGUID_NULL type of objects to be opened.

To obtain a row object using ICommand::Execute method, IID_IRow must be passed. The IMultipleResults interface must be used to handle multiple result sets. IMultipleResults supports IRow and IRowset. IRowset is used for bulk operations.

In This Section

See Also

Rowsets