Image, Audio, and Video Extenders Administration and Programming
Creates a catalog in the currently connected database for the specified
image column. The column must be enabled for image data. The API
creates a name for the catalog, which is used as the qualifier.
Authorization
Alter
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 QbCreateCatalog(
char *tableName,
char *columnName,
SQLINTEGER autoCatalog,
char *reserved
);
Parameters
- tableName (in)
- The name of the table that contains an image column.
- columnName (in)
- The name of the image column for which you are creating a catalog.
- autoCatalog (in)
- Indicates whether images added to the image column will be automatically
cataloged, that is, added to the feature tables and analyzed. Specify 1
to set auto-cataloging on or 0 to set it off. If you don't set
auto-cataloging on, use the QbCatalogColumn or QbCatalogImage APIs to catalog
images that you add to the image column.
- reserved (in)
- Not currently used.
Error codes
- qbicECSqlError
- An SQL error occurred.
- qbicECNotEnabled
- The database, table, or column is not enabled for the DB2Image data
type.
- qbicECDupCatalog
- The catalog already exists.
- qbicECunsupportedOption
- An unsupported option was specified.
- qbicECerrorParameterTooLong
- A parameter was too long for processing.
- qbicECqerr
- A QBIC error occurred, a message was produced.
- qbicECqerrUnknown
- An internal QBIC error occurred, a generic error message was
produced.
Examples
Create a catalog for the images in the picture column of the employee
table. Set auto-cataloging on:
#include <dmbqbapi.h>
rc = QbCreateCatalog("employee",
"picture", 1);
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]