SQLGetData （資料指標程式庫）

重要

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

本主題討論資料指標程式庫中的 SQLGetData 函式用法。 如需 SQLGetData 的 一般資訊，請參閱 SQLGetData 函式 。

資料指標程式庫會先使用 WHERE 子句建構 SELECT 語句 ，以列舉目前資料列中每個系結資料行快取中儲存的值，藉此實 作 SQLGetData 。 然後，它會執行 SELECT 語句來重新選取資料列，並在驅動程式中呼叫 SQLGetData ，以從資料來源擷取資料（而不是快取）。

警告

資料指標程式庫建構的 WHERE 子句無法識別任何資料列、識別不同的資料列，或識別多個資料列。 如需詳細資訊，請參閱 建構搜尋語句 。

如果 SQL_ATTR_USE_BOOKMARKS 語句屬性設定為 SQL_UB_VARIABLE， 可以在資料行 0 上呼叫 SQLGetData 以傳回書簽資料。

對 SQLGetData 的 呼叫受限於下列限制：

• 無法針對向前資料指標呼叫 SQLGetData 。

• 只有在符合下列條件時，才能呼叫 SQLGetData：產生結果集的 SELECT 語句; SELECT 語句不包含聯結、 UNION 子句或 GROUP BY 子句;以及使用選取清單中別名或運算式的任何資料行未系結 SQLBindCol 。

• 如果驅動程式只支援一個使用中語句，資料指標程式庫會在執行 SELECT 語句並呼叫 SQLGetData 之前擷取結果集的其餘部分。