狀態記錄的順序

若有兩份或以上狀態紀錄被回傳,駕駛經理與司機會依下列規則對其進行排名。 排名最高的紀錄是第一個紀錄。 記錄的來源(驅動程式管理器、驅動程式、閘道器等)在排名記錄時不會被考慮。

  • 錯誤 描述錯誤的狀態紀錄享有最高等級。 在錯誤紀錄中,表示交易失敗或可能交易失敗的紀錄高於所有其他紀錄。 若兩個或多個紀錄描述相同的錯誤狀況,Open Group CLI 規範(類別 03 至 HZ)定義的 SQLSTATEs 會優先於 ODBC 定義與驅動程式定義的 SQLSTATE。

  • 實作定義無資料值 描述駕駛者定義的無資料值(類別02)的狀態紀錄排名第二高。

  • 警告 描述警告的狀態紀錄(01類)排名最低。 若兩個或以上紀錄描述相同警告條件,Open Group CLI 規範定義的警告 SQLSTATE 會優先於 ODBC 定義與驅動程式定義的 SQLSTATE。

若有兩個或以上最高排名的紀錄,則不確定哪個紀錄是第一個紀錄。 其他紀錄的順序則未明確定義。 特別是,因為警告可能出現在錯誤之前,應用程式應檢查所有狀態記錄,當函式回傳非 SQL_SUCCESS 值時。