| title | Using IRow::GetColumns (Native Client OLE DB provider) | ||||||
|---|---|---|---|---|---|---|---|
| description | Using IRow::GetColumns in SQL Server Native Client | ||||||
| author | markingmyname | ||||||
| ms.author | maghan | ||||||
| ms.date | 03/06/2017 | ||||||
| ms.service | sql | ||||||
| ms.subservice | native-client | ||||||
| ms.topic | reference | ||||||
| helpviewer_keywords |
|
[!INCLUDESQL Server Azure SQL Database Synapse Analytics PDW]
The IRow implementation allows forward-only sequential access to the columns. You can either access all the columns in the row with a single call to IRow::GetColumns or call IRow::GetColumns multiple times every time that you access several columns in the row.
The multiple calls to IRow::GetColumns should not overlap. For example, if the first call to IRow::GetColumns retrieves columns 1, 2, and 3, the second call to IRow::GetColumns should call for columns 4, 5, and 6. If later calls to IRow::GetColumns overlap, the status flag (dwstatus field in DBCOLUMNACCESS) is set to DBSTATUS_E_UNAVAILABLE.