the type of object to add (which can be GDA_META_DB_UNKNOWN)
the catalog the object belongs to (as a G_TYPE_STRING GValue), or null
the schema the object belongs to (as a G_TYPE_STRING GValue), or null
the object's name (as a G_TYPE_STRING GValue), not null
the #GdaMetaDbObject corresponding to the database object if no error occurred, or null
Creates a new #GdaMetaDbObject structure in mstruct 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>.