IBM Books

Image, Audio, and Video Extenders Administration and Programming

DBvMergeShots


Image Audio Video
    X

Merges two shots into one shot. The resulting shot uses the shot handle and the starting frame of the first shot. The larger end frame of the two shots is used in the resulting shot. The row that the second shot handle points at is deleted.

Authorization

Control, Select, Delete, 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 DBvMergeShots(
      char *catalogName,
      char *shotHandle1,
      char *shotHandle2,
      SQLHDBC hdbc
      );

Parameters

catalogName (in)
The name of the shot catalog.

shotHandle1 (in)
The handle of the first shot.

shotHandle2 (in)
The handle of the second shot.

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_MERGE
Cannot merge shots.

MMDB_RC_INVALID_CATALOG
The catalog is not valid or does not exist.

Examples

Merge the shots with handles shotHandle1 and shotHandle2 in the hotshots catalog:

#include <dmbshot.h>
 
rc = DBvMergeShots("hotshots", shotHandle1,
       shotHandle2, hdbc);


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