IDBSchemaRowsetImpl::CreateSchemaRowset

Article
06/05/2017

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at IDBSchemaRowsetImpl::CreateSchemaRowset.

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

Syntax

  
      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

Share via