使用 ODBC 資料指標程式庫

重要

Windows 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。 Microsoft 建議使用驅動程式的資料指標功能。

若要使用 ODBC 資料指標程式庫，應用程式：

1. 呼叫 具有 屬性的 SQLSetConnectAttr SQL_ATTR_ODBC_CURSORS，以指定資料指標程式庫應該如何搭配特定連接使用。 資料指標程式庫一律可以使用 （SQL_CUR_USE_ODBC），只有在驅動程式不支援可捲動的資料指標（SQL_CUR_USE_IF_NEEDED），或從未使用過 （SQL_CUR_USE_DRIVER） 時才使用。

2. 呼叫 SQLConnect、 SQLDriverConnect 或 SQLBrowseConnect 以連線到資料來源。

3. 呼叫 SQLSetStmtAttr 來指定資料指標類型 （SQL_ATTR_CURSOR_TYPE）、並行 （SQL_ATTR_CONCURRENCY），以及資料列集大小 （SQL_ATTR_ROW_ARRAY_SIZE）。 資料指標程式庫支援正向和靜態資料指標。 正向資料指標必須是唯讀的，而靜態資料指標可以是唯讀的，也可以使用開放式並行控制來比較值。

4. 配置一或多個資料列集緩衝區，並呼叫 SQLBindCol 一或多次，將這些緩衝區系結至結果集資料行。

5. 藉由執行 SELECT 語句或程式，或藉由呼叫 catalog 函式來產生結果集。 如果應用程式將執行定位的 update 語句，它應該執行 SELECT FOR UPDATE 語句來產生結果集。

6. 呼叫 SQLFetch 或 SQLFetchScroll 一或多次以捲動結果集。

應用程式可以變更資料列集緩衝區中的資料值。 若要使用資料指標程式庫快取的資料重新整理資料列集緩衝區，應用程式會呼叫 SQLFetchScroll ，並將 FetchOrientation 引數設定為 SQL_FETCH_RELATIVE，並將 FetchOffset 引數設定為 0。

若要從未系結的資料行擷取資料，應用程式會呼叫 SQLSetPos ，將游標放在所需的資料列上。 然後它會呼叫 SQLGetData 來擷取資料。

若要判斷從資料來源擷取的資料列數目，應用程式會呼叫 SQLRowCount 。