CRecordset::FlushResultSet

BOOL FlushResultSet () const;
Бросай (CDBException);

Возвращаемое значение

Ненулевое значение, если есть несколько результирующих наборов для извлечения; в противном случае 0.

Примечания

Вызов этой функции-члена, чтобы получить следующий результирующий набор предопределенного запроса (хранимая процедура), если существует несколько результирующих наборов. FlushResultSet следует вызывать только тогда, когда вы полностью закончены с курсором на текущем результирующем наборе. Обратите внимание, что при получении следующего результирующего набора путем вызова FlushResultSet, ваш курсор не поддерживается на что результирующего набора; следует вызвать функцию-член MoveNext после вызова FlushResultSet.

Если предопределенный запрос использует выходного параметра или параметров ввода/вывода, необходимо вызвать FlushResultSet до тех пор, пока он возвращает значение FALSE (значение 0), с тем чтобы получить эти значения параметров.

FlushResultSet вызывает функцию интерфейса API ODBC SQLMoreResults. Если SQLMoreResults возвращает SQL_ERROR или SQL_INVALID_HANDLE, FlushResultSet будет сгенерировано исключение. Для получения дополнительных сведений о функции SQLMoreResultsприведена в справочнике программиста ODBC SDK.

Пример

В следующем коде предполагается, что COutParamRecordset является CRecordset-производный объект на основе предопределенного запроса с входным и выходным параметрами и имеющие несколько результирующих наборов. Примечание структура DoFieldExchange отменяют.

// DoFieldExchange override
//
// Only necessary to handle parameter bindings.
// Don't use CRecordset-derived class with bound
// fields unless all result sets have same schema
// OR there is conditional binding code.

void COutParamRecordset::DoFieldExchange( CFieldExchange* pFX )
{
   pFX->SetFieldType( CFieldExchange::outputParam );
   RFX_Long( pFX, "Param1", m_nOutParamInstructorCount );
         // The "Param1" name here is a dummy name 
         // that is never used

   pFX->SetFieldType( CFieldExchange::inputParam );
   RFX_Text( pFX, "Param2", m_strInParamName );
         // The "Param2" name here is a dummy name 
         // that is never used

}


// Now implement COurParamRecordset.

// Assume db is an already open CDatabase object
COutParamRecordset rs( &db );
rs.m_strInParamName = _T("Some_Input_Param_Value");

// Get the first result set
// NOTE: SQL Server requires forwardOnly cursor 
//       type for multiple rowset returning stored 
//       procedures
rs.Open( CRecordset::forwardOnly, 
         "{? = CALL GetCourses( ? )}", 
         CRecordset::readOnly);

// Loop through all the data in the first result set
while ( !rs.IsEOF( ) )
{
   CString strFieldValue;
   for( int nIndex = 0; 
        nIndex < rs.GetODBCFieldCount( ); 
        nIndex++ )
   {
      rs.GetFieldValue( nIndex, strFieldValue );

      // TO DO: Use field value string.
   }
   rs.MoveNext( );
}

// Retrieve other result sets...
while( rs.FlushResultSet( ) )
{
   // must call MoveNext because cursor is invalid
   rs.MoveNext( );

   while ( !rs.IsEOF( ) )
   {
      CString strFieldValue;
      for( int nIndex = 0; 
           nIndex < rs.GetODBCFieldCount( ); 
           nIndex++ )
      {
         rs.GetFieldValue( nIndex, strFieldValue );

         // TO DO: Use field value string.
      }
      rs.MoveNext( );
   }
}


// All result sets have been flushed. Cannot
// use the cursor, but the output parameter,
// m_nOutParamInstructorCount, has now been written.
// Note that m_nOutParamInstructorCount not valid until
// CRecordset::FlushResultSet has returned FALSE,
// indicating no more result sets will be returned.

// TO DO: Use m_nOutParamInstructorCount

// Cleanup
rs.Close( );
db.Close( );

Обзор CRecordset |  Члены класса | Иерархическая схема

См. также CFieldExchange::SetFieldType