IBM Books

Image, Audio, and Video Extenders Administration and Programming

QbOpenCatalog


Image Audio Video
X    

Opens the QBIC catalog for a specific image column. You can open the catalog in read mode or update mode. The API returns a handle for the opened catalog. You then use the handle in other APIs to manage and populate the catalog.

Make sure you close the catalog after you are finished with it.

Authorization

None

Library file
OS/2 and Windows AIX, HP-UX, and Solaris
dmbqbapi.lib libdmbqbapi.a (AIX)

libdmbqbapi.sl (HP-UX)

libdmbqbapi.so (Solaris)

Include file

dmbqbapi.h

Syntax

SQLRETURN QbOpenCatalog(
      char *tableName,
      char *columnName,
      SQLINTEGER mode,
      QbCatalogHandle *cHdl
      );

Parameters

tableName (in)
The table name containing the image column.

columnName (in)
The name of the image column.

mode (in)
The mode in which you are opening the catalog. Valid values are qbiRead and qbiUpdate.

cHdl (out)
A pointer to the handle of the catalog.

Error codes

qbicECCatalogNotFound
The catalog was not found.

qbicECCatalogInUse
The catalog was being used by someone else.

qbicECOpenFailed
The catalog could not be opened.

qbicECNotEnabled
The catalog is not enabled.

qbicECNoCatalogFound
No catalog was found.

qbicECSqlError
An SQL error occurred.

qbicECSystem
A system error occurred.

Examples

Open the catalog for the picture column in the employee table in read mode:

#include <dmbqbapi.h>
 
rc=QbOpenCatalog("employee", "picture",
     qbiread, &CatHdl);


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]