ICommandImpl::CreateRowset

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 ICommandImpl::CreateRowset.

Called by Execute to create a single rowset.

Syntax

  
      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

Share via