Image, Audio, and Video Extenders Administration and Programming
Stores and names a query object so that you can use it in a UDF. You
provide the name and can provide the description of the query object.
Notes:
- EEE Only: QbQueryNameCreate is not supported in a
partitioned database environment.
- QbQueryNameCreate will be deprecated in future releases for
non-partitioned database environments. To save a query, you should use
QbQueryGetString to get the query string and save that string for later use in
your application.
Authorization
None.
Library file
OS/2 and Windows
| AIX, HP-UX, and Solaris
|
dmbqqry.lib
| libdmbqqry.a (AIX)
|
| libdmbqqry.sl (HP-UX)
|
| libdmbqqry.so (Solaris)
|
Include file
dmbqbapi.h
Syntax
SQLRETURN QbQueryNameCreate(
QbQueryHandle qObj,
char *name,
char *description
);
Parameters
- qObj (in)
- The handle of the query object.
- name (in)
- The name of the query object. The name can be up to 18
characters.
- description (in)
- A brief description of the query object, up to 250 characters.
Error codes
- qbiECinvalidQueryHandle
- The query object handle that you specified does not reference a valid
query .
Examples
Give a name and description to the query object created with the
QbQueryCreate API:
#include <dmbqbapi.h>
rc = QbQueryNameCreate(qHandle,
"fshavgcol",
"average color query, 10/15/96");
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]