IDBSchemaRowsetImpl::CreateSchemaRowset

template < class SchemaRowsetClass >
HRESULT CreateSchemaRowset( IUnknown *pUnkOuter, ULONG
cRestrictions**, const VARIANT** rgRestrictions**[], REFIID** riid**, ULONG** cPropertySets**, DBPROPSET** rgPropertySets**[], IUnknown**** ppRowset**, SchemaRowsetClass*&** pSchemaRowset );

Return Value

A standard HRESULT value.

Parameters

pUnkOuter

[in] An outer when aggregating, otherwise NULL.

cRestrictions

[in] The count of restrictions applied to the schema rowset.

rgRestrictions

[in] An array of cRestrictionsVARIANTs to be applied to the rowset.

riid

[in] The interface to QueryInterface for on the output IUnknown.

cPropertySets

[in] The number of property sets being set.

rgPropertySets

[in] An array of cPropertySetsDBPROPSETS that specify the properties being set. For information about the structure DBPROPSETS, see Chapter 11 in the OLE DB Programmer's Reference.

ppRowset

[out] The outgoing IUnknown requested by riid. This IUnknown is an interface on the schema rowset object.

pSchemaRowset

[out] A pointer to an instance of the schema rowset class. Typically this parameter is not used, but it can be used if you must perform more work on the schema rowset before handing it out to a COM object. The lifetime of pSchemaRowset is bound by ppRowset.

Remarks

This function implements a COM object creator function for the object specified by the template parameter. In effect this function implements a generic creator for all types of schema rowsets. Typically, the user does not call this function. It is called by the implementation of the schema map.

IDBSchemaRowsetImpl OverviewIDBSchemaRowsetImpl Class Members

See Also

SCHEMA_ENTRY, Schema Rowset Classes and Typedef Classes