SQL Server Native Client での IRow::GetColumns の使用

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

IRow の実装では、列に対して順方向専用の順次アクセスを実行できます。 IRow::GetColumns を 1 回だけ呼び出して、行内のすべての列にアクセスすることができます。また、行内の複数の列にアクセスするたびに、毎回 IRow::GetColumns を呼び出すこともできます。

IRow::GetColumns を複数回呼び出す場合は、呼び出しが重ならないようにする必要があります。 たとえば、1 回目に IRow::GetColumns を呼び出すときに列 1、2、3 を取得する場合、2 回目に IRow::GetColumns を呼び出すときには列 4、5、6 を取得する必要があります。 IRow::GetColumns の呼び出しが重なると、状態フラグ (DBCOLUMNACCESS の dwstatus フィールド) が DBSTATUS_E_UNAVAILABLE に設定されます。

参照

IRow による 1 行のフェッチ