The CATALOGS schema rowset returns metadata that indicates which catalogs can be accessed by the provider. Each row in the CATALOGS schema rowset corresponds to one catalog available in the provider.
The following table describes the columns that are available in the CATALOGS schema rowset.
| Column Name | Type Indicator | Mapped Value | Restrictions Supported? |
|---|---|---|---|
| CATALOG_NAME | DBTYPE_WSTR | Name of the catalog. Cannot be NULL. | Yes |
| DESCRIPTION | DBTYPE_WSTR | Description of the catalog. | No |
Restrictions enable an OLE DB consumer to restrict the rows that are returned in a schema rowset by IDBSchemaRowset::GetRowset. A restriction is a value for a specific column. When a restriction is passed to IDBSchemaRowset::GetRowset, all rows that are returned in the schema rowset must match the restriction value on the specified column. Restriction values do not support pattern matching or wildcards. For example, the restriction value D_F matches D_F but not DEF.
An OLE DB consumer can programmatically discover the columns on which the providers support restrictions by calling IDBSchemaRowset::GetSchemas.
Note: For definitions of the type indicators, see "Type Indicators" in Microsoft's OLE DB specification documentation.