Partager via


CRecordset::GetStatus

Détermine l'index de l'enregistrement en cours dans le recordset et si le dernier enregistrement a été rencontré.

void GetStatus( 
   CRecordsetStatus& rStatus  
) const;

Paramètres

  • rStatus
    Une référence à un objet de CRecordsetStatus . Pour plus d'informations, consultez la section Notes.

Notes

CRecordset tente de suivre l'index, mais dans certains cas cela peut ne pas être possible. Consultez GetRecordCount pour obtenir une explication.

La structure de CRecordsetStatus a la forme suivante :

struct CRecordsetStatus

{

long m_lCurrentRecord;

BOOL m_bRecordCountFinal;

};

Les deux membres de CRecordsetStatus ont les significations suivantes :

  • m_lCurrentRecord contient l'index de base zéro de l'enregistrement en cours dans le recordset, le cas échéant. Si l'index ne peut pas être déterminé, ce membre contient AFX_CURRENT_RECORD_UNDEFINED (– 2). Si IsBOF est TRUE (recordset vide ou tentative de défilement avant le premier enregistrement), alors m_lCurrentRecord a la valeur AFX_CURRENT_RECORD_BOF (– 1). Si sur le premier enregistrement, il a la valeur 0, l'enregistrement de 1 secondes, et ainsi de suite.

  • m_bRecordCountFinal Une Valeur Différente De Zéro si le nombre total d'enregistrements du recordset a été déterminée. En général cela doit être effectué en démarrant au début du recordset et en appelant MoveNext jusqu'à ce qu' IsEOF retourne une valeur différente de zéro. Si ce membre a zéro ans, le nombre d'enregistrements comme retourné par GetRecordCount, sinon – 1, est uniquement un nombre « de jeton de haute eaux » des enregistrements.

Configuration requise

Header: afxdb.h

Voir aussi

Référence

CRecordset, classe

Graphique de la hiérarchie

CRecordset::GetRecordCount