SQLBindCol （資料指標程式庫）

重要

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

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

應用程式會為數據指標程式庫配置一或多個緩衝區，以傳回 中的目前資料列集。 它會呼叫 SQLBindCol 一或多次，將這些緩衝區系結至結果集。

應用程式可以在呼叫 SQLExtendedFetch、SQLFetch 或 SQLFetchScroll 之後呼叫 SQLBindCol 來重新系結結果集資料行，只要系結資料行的 C 資料類型、 資料行大小和十進位數保持不變。 應用程式不需要關閉資料指標，才能將資料行重新系結至不同的位址。

資料指標程式庫支援將 SQL_ATTR_ROW_BIND_OFFSET_PTR 語句屬性設定為使用系結位移。 （ SQLBindCol 不需要呼叫此重新系結即可發生。如果資料指標程式庫與 ODBC 3.x 驅動程式搭配使用，則呼叫 SQLFetch 時 不會使用系結位移。 當 資料指標程式庫搭配 ODBC 2.x 驅動程式使用時，會使用系結位移，因為 SQLFetch 接著會對應至 SQLExtendedFetch 。

資料指標程式庫支援呼叫 SQLBindCol 來系結書簽資料行。

使用 ODBC 2.x 驅動程式時，當呼叫 SQLBindCol ，將書簽資料行的緩衝區長度設定為不等於 4 的值時 ，資料指標程式庫會傳回 SQLSTATE HY090 （不正確字串或緩衝區長度）。 使用 ODBC 3.x 驅動程式時，資料指標程式庫可讓緩衝區成為任何大小。