IDBSchemaRowsetImpl::CreateSchemaRowset

Implements a COM object creator function for the object specified by the template parameter.

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

Parameters

  • pUnkOuter
    [in] An outer IUnknown 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 to set.

  • rgPropertySets
    [in] An array of DBPROPSET structures that specify the properties being set.

  • 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.

Return Value

A standard HRESULT value.

Remarks

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.

Requirements

Header: atldb.h

See Also

Reference

IDBSchemaRowsetImpl Class

SCHEMA_ENTRY

Schema Rowset Classes and Typedef Classes

Other Resources

IDBSchemaRowsetImpl Class Members