SQLGetData 返回指定列中的数据。 只有在 SQLFetch、 SQLFetchScroll 或 SQLExtendedFetch 从结果集中提取一行或多行之后，才能调用 SQLGetData 。 如果由于应用程序) 的限制，长度可变的数据太大，无法在对 SQLGetData (的单个调用中返回， SQLGetData 可以分部分检索它。 可以绑定行中的某些列，并为其他列调用 SQLGetData ，尽管这受到一些限制。 有关详细信息，请参阅 获取长数据 。

有关将 SQLGetData 与流式输出参数配合使用的信息，请参阅 使用 SQLGetData 检索输出参数 。

使用 SQLGetData

如果驱动程序不支持 SQLGetData 扩展，则函数只能返回数字大于最后一个绑定列的未绑定列的数据。 此外，在一行数据中，每次调用 SQLGetData 时 Col_or_Param_Num 参数的值必须大于或等于上一次调用中 Col_or_Param_Num 的值;也就是说，必须按增加列号顺序检索数据。 最后，如果不支持任何扩展，则如果行集大小大于 1，则无法调用 SQLGetData 。

驱动程序可以放宽其中的任何限制。 为了确定驱动程序放宽哪些限制，应用程序使用以下任一SQL_GETDATA_EXTENSIONS选项调用 SQLGetInfo ：

这些限制有两个例外，以及驾驶员放宽限制的能力。 首先，当行集大小大于 1 时，绝不应为仅进游标调用 SQLGetData 。 其次，如果驱动程序支持书签，它必须始终支持为列 0 调用 SQLGetData 的功能，即使它不允许应用程序在最后一个绑定列之前为其他列调用 SQLGetData 。 (当应用程序使用 ODBC 2*.x* 驱动程序时， 调用 SQLFetch 后，当调用 Col_or_Param_Num 等于 0 时 ，SQLGetData 将成功返回书签，因为 SQLFetch 由 ODBC 3*.x* 驱动程序管理器映射到 SQLExtendedFetch ，且 SQL_FETCH_NEXT Col_or_Param_Num 为 0 的 SQLGetData 由 ODBC 3*.x* 驱动程序管理器映射到 SQLGetStmtOption SQL_GET_BOOKMARK.) 的 fOption

SQLGetData 不能用于检索刚刚通过使用 SQL_ADD 选项调用 SQLBulkOperations 插入的行的书签，因为游标未定位在行上。 在使用 SQL_ADD 调用 SQLBulkOperation 之前，应用程序可以通过绑定列 0 来检索此类行的书签，在这种情况下 ，SQLBulkOperations 将返回绑定缓冲区中的书签。 然后，可以使用 SQL_FETCH_BOOKMARK 调用 SQLFetchScroll ，以将游标重新定位到该行上。

如果 TargetType 参数是间隔数据类型，则默认间隔前导精度 (2) 和默认间隔秒精度 (6) ，如 ARD 的SQL_DESC_DATETIME_INTERVAL_PRECISION和SQL_DESC_PRECISION字段中设置的那样，将分别用于数据。 如果 TargetType 参数是SQL_C_NUMERIC数据类型，则默认精度 (驱动程序定义的) 和默认小数位数 (0) （如 ARD 的SQL_DESC_PRECISION和SQL_DESC_SCALE字段中设置）用于数据。 如果任何默认精度或小数位数都不适用，应用程序应通过调用 SQLSetDescField 或 SQLSetDescRec 显式设置相应的描述符字段。 它可以将SQL_DESC_CONCISE_TYPE字段设置为SQL_C_NUMERIC，并使用 targetType 参数SQL_ARD_TYPE调用 SQLGetData ，这将导致使用描述符字段中的精度和小数位数值。

在 ODBC 2*.x* 中，应用程序将 TargetType 设置为 SQL_C_DATE、SQL_C_TIME 或 SQL_C_TIMESTAMP，以指示 * TargetValuePtr 是日期、时间或时间戳结构。 在 ODBC 3*.x* 中，应用程序将 TargetType 设置为 SQL_C_TYPE_DATE、SQL_C_TYPE_TIME 或 SQL_C_TYPE_TIMESTAMP。 驱动程序管理器根据需要根据应用程序和驱动程序版本进行适当的映射。

检索部件中的Variable-Length数据

SQLGetData 可用于从包含可变长度数据的列中检索数据（即，当列的 SQL 数据类型的标识符为SQL_CHAR、SQL_VARCHAR、SQL_LONGVARCHAR、SQL_WCHAR、SQL_WVARCHAR、SQL_WLONGVARCHAR、SQL_BINARY、SQL_VARBINARY、SQL_LONGVARBINARY或可变长度类型的特定于驱动程序的标识符时）。

若要从分部分的列中检索数据，应用程序会连续多次为同一列调用 SQLGetData 。 每次调用时， SQLGetData 都会返回数据的下一部分。 应用程序负责重新组合部分，并注意从字符数据的中间部分删除 null 终止字符。 如果要返回的数据更多，或者没有为终止字符分配足够的缓冲区， SQLGetData 将返回SQL_SUCCESS_WITH_INFO，SQLSTATE 01004 (数据截断) 。 当它返回数据的最后一部分时， SQLGetData 返回SQL_SUCCESS。 在最后一次从列检索数据的有效调用中，不能返回SQL_NO_TOTAL和零，因为应用程序随后无法知道应用程序缓冲区中有多少数据有效。 如果在此之后调用 SQLGetData ，它将返回SQL_NO_DATA。 有关详细信息，请参阅下一节“使用 SQLGetData 检索数据”。

SQLGetData 可以分部分返回长度可变的书签。 与其他数据一样，调用 SQLGetData 以在部件中返回可变长度书签将返回 SQLSTATE 01004 (String 数据，) 右截断，并在返回更多数据时SQL_SUCCESS_WITH_INFO。 这不同于通过调用 SQLFetch 或 SQLFetchScroll 截断可变长度书签的情况，后者返回SQL_ERROR和 SQLSTATE 22001 (字符串数据，右截断) 。

SQLGetData 不能用于返回部件中的固定长度数据。 如果对包含固定长度数据的列在一行中多次调用 SQLGetData，则对于第一次之后的所有调用， SQLGetData 都会返回SQL_NO_DATA。

检索流式处理输出参数

如果驱动程序支持流式输出参数，应用程序可以使用小缓冲区多次调用 SQLGetData 来检索较大的参数值。 有关流输出参数的详细信息，请参阅 使用 SQLGetData 检索输出参数 。

使用 SQLGetData 检索数据

若要返回指定列的数据， SQLGetData 将执行以下一系列步骤：

如果列的数据不为 NULL， 则 SQLGetData 将继续执行步骤 3。

SQL_ATTR_MAX_LENGTH 语句属性旨在减少网络流量。 它通常由数据源实现，数据源在通过网络返回数据之前会截断数据。 无需驱动程序和数据源即可支持它。 因此，若要保证数据被截断为特定大小，应用程序应分配该大小的缓冲区，并在 BufferLength 参数中指定该大小。

如果提供的数据缓冲区太小，无法容纳 null 终止字符， 则 SQLGetData 将返回SQL_SUCCESS_WITH_INFO和 SQLSTATE 01004。

SQLGetData 永远不会截断转换为固定长度数据类型的数据;它始终假定 * TargetValuePtr 的长度是数据类型的大小。

如果在绑定列) 上调用 SQLGetData ，则绑定数据缓冲区的内容 (;如果 SQLGetData 不返回SQL_SUCCESS或SQL_SUCCESS_WITH_INFO，则长度/指示器缓冲区未定义。

对 SQLGetData 的连续调用将从请求的最后一列检索数据;以前的偏移量变为无效。 例如，执行以下顺序时：

SQLGetData(icol=n), SQLGetData(icol=m), SQLGetData(icol=n)  
第二次调用 SQLGetData (icol=n) 从 n 列的开头检索数据。 由于先前对列的 SQLGetData 调用而导致数据中的任何偏移量都不再有效。
描述符和 SQLGetData
SQLGetData 不直接与任何描述符字段交互。
如果 TargetType SQL_ARD_TYPE，则使用 ARD SQL_DESC_CONCISE_TYPE 字段中的数据类型。 如果 TargetType 为SQL_ARD_TYPE或SQL_C_DEFAULT，则会根据SQL_DESC_CONCISE_TYPE字段中的数据类型，在 ARD 的SQL_DESC_DATETIME_INTERVAL_PRECISION、SQL_DESC_PRECISION和SQL_DESC_SCALE字段中为数据提供精度和小数位数。
在以下示例中，应用程序执行 SELECT 语句以返回按姓名、ID 和电话号码排序的客户 ID、姓名和电话号码的结果集。 对于每行数据，它调用 SQLFetch 将游标定位到下一行。 它调用 SQLGetData 来检索提取的数据;在调用 SQLGetData 时指定数据的缓冲区和返回的字节数。 最后，它打印每个员工的姓名、ID 和电话号码。
#define NAME_LEN 50  
#define PHONE_LEN 50  
SQLCHAR      szName[NAME_LEN], szPhone[PHONE_LEN];  
SQLINTEGER   sCustID, cbName, cbAge, cbBirthday;  
SQLRETURN    retcode;  
SQLHSTMT     hstmt;  
retcode = SQLExecDirect(hstmt,  
   "SELECT CUSTID, NAME, PHONE FROM CUSTOMERS ORDER BY 2, 1, 3",  
   SQL_NTS);  
if (retcode == SQL_SUCCESS) {  
   while (TRUE) {  
      retcode = SQLFetch(hstmt);  
      if (retcode == SQL_ERROR || retcode == SQL_SUCCESS_WITH_INFO) {  
         show_error();  
      if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO){  
         /* Get data for columns 1, 2, and 3 */  
         SQLGetData(hstmt, 1, SQL_C_ULONG, &sCustID, 0, &cbCustID);  
         SQLGetData(hstmt, 2, SQL_C_CHAR, szName, NAME_LEN, &cbName);  
         SQLGetData(hstmt, 3, SQL_C_CHAR, szPhone, PHONE_LEN,  
            &cbPhone);  
         /* Print the row of data */  
         fprintf(out, "%-5d %-*s %*s", sCustID, NAME_LEN-1, szName,   
            PHONE_LEN-1, szPhone);  
      } else {  
         break;  
有关以下方面的信息