SQLGetConnect屬性-取得連線屬性的值

線上編輯

SQLGetConnectAttr() 會傳回指定連線選項的現行設定。

這些選項是使用 SQLSetConnectAttr() 函數來設定。

Unicode (UTF-16) 相等: 此函數也可以與 Unicode (UTF-16) 字集搭配使用。 對應的 Unicode 函數為 SQLGetConnectAttrW()。 如需 DB2® CLI 的 Unicode 支援的相關資訊，請參閱 Db2 for i CLI 中的 Unicode 。

語法

SQLRETURN SQLGetConnectAttr(   SQLHDBC      hdbc,
                               SQLINTEGER   fAttr,
                               SQLPOINTER   pvParam),;
                               SQLINTEGER   bLen,
                               SQLINTEGER   *sLen);

函數引數

表 1. SQLGetConnect屬性引數
資料類型 引數 使用 說明
SQLHDBC hdbc 輸入 連線控點。
SQLINTEGER fAttr 輸入 要擷取的屬性。 如需連接選項的說明，請參閱 SQLSetConnect屬性-設定連線屬性 。
SQLPOINTER pvParam 輸出 與 fAttr 相關聯的值，視 fAttr的值而定。 這可以是 32 位元整數值，或是空值終止字串的指標。
SQLINTEGER bLen 輸入 如果值是字串，則儲存在 pvParm中的位元組數上限; 否則為未用。
SQLINTEGER * sLen 輸出 輸出資料的長度 (如果屬性是字串); 否則，未使用。

用法

無法透過 SQLGetConnectAttr()擷取陳述式選項設定。

診斷

表 2. SQLGetConnect屬性 SQLSTATE
SQL狀態 說明 說明
08003 連線未開啟 指定需要開啟連線的 fAttr 值。
HY001 記憶體配置失敗 驅動程式無法配置支援處理或完成函數所需的記憶體。
HY009 屬性類型超出範圍 指定無效的 fAttr 值。

引數 pvParam 是空值指標。
HYC00 驅動程式無法使用 fAttr 引數可辨識，但不受支援。