IBM Books

Image, Audio, and Video Extenders Administration and Programming

DBvUpdateShot


Image Audio Video
    X

Replaces the attributes of a video shot in the catalog. All the attributes, except for the comment, are replaced by the attributes in the DBvShotType structure. If the remark pointer is NULL, the existing remark remains unchanged.

Authorization

Control, Update

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

libdmbshot.sl (HP-UX)

libdmbshot.so (Solaris)

Include file

dmbshot.h

Syntax

long DBvUpdateShot(
      char *catalogName,
      DBvShotType *shot,
      char *shotHandle,
      SQLHDBC hdbc
      );

Parameters

catalogName (in)
The name of the catalog.

shot (in)
The pointer to shot information structure containing attributes of the shot.

shotHandle (in)
The shot handle.

hdbc (in)
The database handle from SQLConnect.

Error codes

MMDB_SUCCESS
API call processed successfully.

MMDB_RC_NOT_CONNECTED
The application does not have valid connection to a database.

MMDB_RC_CANNOT_UPDATE
The API cannot update the shot.

MMDB_RC_NO_SHOT
The shot does not exist.

MMDB_RC_INVALID_CATALOG
The catalog is not valid or does not exist.

Examples

Update the attributes of a shot in the hotshots catalog:

#include <dmbshot.h>
 
rc = DBvUpdateShot("hotshots", shot,
       shothandle, hdbc);


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