您必須開啟 QBIC 型錄,才能執行變更型錄的後續動作。例如,在新增特性到型錄之前,必須先 開啟 QBIC 型錄。
若要開啟 QBIC 型錄,請使用 QbOpenCatalog API 呼叫或 OPEN QBIC CATALOG 指令。
若型錄已開啟,則情形如何?如果型錄已開啟, 供另一個階段作業更新之用,則您無法再開啟型錄供更新作業使用。 當您開啟某 QBIC 型錄時,Image Extender 會關閉現行階段作業中已開啟的任何 QBIC 型錄。
使用 API:當您使用 QbOpenCatalog API 時, 請明確指定要開啟型錄的模式。 請指定:
QbiRead 和 QbiUpdate 是定義於 QBIC 併入檔 (標頭檔) dmbqbapi.h 中的常數。
您也需要指向型錄 handle。型錄 handle 有一種 QBIC 特定資料類型 QbCatalogHandle。 此資料類型也定義在 dmbqbapi.h 中。Image Extender 會傳回型錄 handle 值作為來自 API 的輸出值。
例如,下列 API 呼叫可開啟 QBIC 型錄,供讀取自該型錄的作業使用:
SQLINTEGER mode; QbCatalogHandle *CatHdl; mode=qbiRead; /* open catalog for */ /* read operations */ rc=QbOpenCatalog( "employee", /* user table */ "picture", /* image column */ mode, /* open catalog mode */ &CatHdl); /* catalog handle */
使用指令行:當您使用 OPEN QBIC CATALOG 指令時,Image Extender 會嘗試開啟更新作業使用的型錄。 如果所開啟的型錄目前被另一個階段作業作為更新之用,Image Extender 會開啟讀取作業的型錄。
例如,下列指令可開啟 QBIC 型錄;Image Extender 會嘗試開啟它供更新作業使用:
OPEN QBIC CATALOG employee picture
完成 QBIC 相關的活動後關閉型錄:開啟 QBIC 型錄時,Image Extender 會配置一些資源給它,如記憶體。 完成 QBIC 相關活動後,關閉型錄。 這可釋放所配置的資源。