Share via

ICommandImpl::CreateRowset

  • Article

Called by Execute to create a single rowset.

template <class RowsetClass> 
HRESULT CreateRowset( 
   IUnknown* pUnkOuter, 
   REFIID riid, 
   DBPARAMS* pParams, 
   DBROWCOUNT* pcRowsAffected, 
   IUnknown** ppRowset, 
   RowsetClass*& pRowsetObj  
);

Parameters

  • RowsetClass
    A template class member representing the user's rowset class. Usually generated by the wizard.

  • pUnkOuter
    [in] A pointer to the controlling IUnknown interface if the rowset is being created as part of an aggregate; otherwise, it is null.

  • riid
    [in] Corresponds to riid in ICommand::Execute.

  • pParams
    [in/out] Corresponds to pParams in ICommand::Execute.

  • pcRowsAffected
    Corresponds to pcRowsAffected in ICommand::Execute.

  • ppRowset
    [in/out] Corresponds to ppRowset in ICommand::Execute.

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

Return Value

A standard HRESULT value. See ICommand::Execute for a list of typical values.

Remarks

To create more than one rowset, or to provide your own conditions for creating different rowsets, place different calls to CreateRowset from within Execute.

See ICommand::Execute in the OLE DB Programmer's Reference.

Requirements

Header: atldb.h

See Also

Reference

ICommandImpl Class