CRecordset::FlushResultSet

BOOL (FlushResultSet) константа;
кинути (CDBException);

Значення, яке повертається

Ненульовий, якщо є більше результат набори завантажуються; в іншому випадку 0.

Зауваження

Телефонувати цієї функції-члена для отримання наступного набору результатів попередньо визначений запит (збережені процедури), є кілька наборів результат. Телефонуйте FlushResultSet тільки, коли ви повністю закінчили з курсором на поточному наборі результатів. Зверніть увагу, що при отриманні наступного набору по телефону FlushResultSetрезультатів, курсор не дійсні на що набору результатів; Ви повинні викликати функцію член MoveNext після виклику FlushResultSet.

Якщо попередньо визначений запит використовує виводу-параметрів або параметрів вводу виводу, ви повинні викликати FlushResultSet , доки він не поверне ПОМИЛКОВИХ (значення 0), з тим щоб отримати ці значення параметра.

FlushResultSet дзвінки функції ODBC API SQLMoreResults. Якщо SQLMoreResults SQL_ERROR або SQL_INVALID_HANDLE, FlushResultSet буде кидати виняток. Щоб отримати додаткові відомості про SQLMoreResultsпобачити посилання SDK програміста ODBC.

Приклад

Наступний код припускає, що 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