template <class RowsetClass>
HRESULT CreateRowset( IUnknown* pUnkOuter, REFIID riid, DBPARAMS * pParams, LONG * pcRowsAffected, IUnknown** ppRowset, RowsetClass*& pRowsetObj );
See ICommand::Execute in the OLE DB Programmer's Reference.
Return Value
A standard HRESULT value. See ICommand::Execute for a list of typical values.
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.
Remarks
Called by Execute to create a single rowset. To create more than one rowset, or to provide your own conditions for creating different rowsets, place different calls to CreateRowset from within Execute.