IBM Books

Image, Audio, and Video Extenders Administration and Programming

DBaAdminIsFileReferenced


Image Audio Video
  X  

Returns a list of audio column entries in user tables that refer to a specified file. The application must be connected to a database before calling this API.

It is important that you free up the resources that are allocated by this API after calling it. Specifically, you must free up the filelist data structure as well as the filename field in each entry in the filelist.

Authorization

SYSADM, SYSCTRL, SYSMAINT

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

libdmbaudio.sl (HP-UX)

libdmbaudio.so (Solaris)

Include file

dmbaudio.h

Syntax

long DBaAdminIsFileReferenced(
      char *qualifier,
      char *fileName,
      long *count,
      FILEREF *(*tableList)
      );

Parameters

qualifier (in)
A valid user ID or a null value. If a user ID is specified, all tables with the specified qualifier are searched. If a null value is specified, all tables in the current database are searched.

fileName (in)
the name of the referred to file.

count (out)
The number of entries in the output list.

tableList (out)
A list of table entries that refer to the specified file.

Error codes

MMDB_SUCCESS
API call processed successfully.

MMDB_RC_NOT_CONNECTED
Application does not have valid connection to a database.

MMDB_RC_MALLOC
System cannot allocate memory to return the results.

MMDB_RC_NO_AUTH
User does not have proper authority to call this API.

Examples

List the entries in audio columns in all tables in the current database that refer to file /audios/asmith.wav:

#include <dmbaudio.h>
long idx;
 
rc = DBaAdminIsFileReferenced(NULL,
       "/audios/asmith.wav",
       &count, &tableList);


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