complement

Creates a new MetaDbObject structure in this to represent the database object (of type type) which can be uniquely identified as catalog.

schema.name.

If catalog is not null, then schema should not be null .

If both catalog and schema are null, then the database object will be the one which is "visible" by default (that is which can be accessed only by its short name name).

If catalog is null and schema is not null, then the database object will be the one which can be accessed by its schema.name name.

Important note: catalog, schema and name will be used using the following convention: <itemizedlist > <listitem><para>be surrounded by double quotes for a case sensitive search</para></listitem> <listitem>< para>otherwise for case insensitive search</para></listitem> </itemizedlist>

For more information, see the <link linkend="information_schema:sql_identifiers"> meta data section about SQL identifiers</link>.

Parameters:

this	a MetaStruct object
type	the type of object to add (which can be GDA_META_DB_UNKNOWN)
catalog	the catalog the object belongs to (as a G_TYPE_STRING GValue), or null
schema	the schema the object belongs to (as a G_TYPE_STRING GValue), or null
name	the object's name (as a G_TYPE_STRING GValue), not null

Returns:

the MetaDbObject corresponding to the database object if no error occurred, or null