IBM Books

Image, Audio, and Video Extenders Administration and Programming

DBvSetShotComment


Image Audio Video
    X

Updates the read-only comment within the shot.

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 DBvSetShotComment(
      char *catalogName,
      char *shotHandle,
      char *comment,
      SQLHDBC hdbc
      );

Parameters

catalogName (in)
The name of the catalog.

shotHandle (in)
The handle of the shot to be updated.

comment (in)
The new comment for the 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_UPDATE
The API cannot update the shot.

MMDB_RC_INVALID_CATALOG
The catalog is not valid or does not exist.

Examples

Change the remark describing the shot with the shotHandle in the catalog hotshots:

#include <dmbshot.h>
 
rc = DBvSetShotComment("hotshot", shotHandle,
       "This is a hot shot.", hdbc);


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