CRecordset::SetRowsetCursorPosition
Déplace le curseur d'une ligne dans l'ensemble de lignes actuel.
void SetRowsetCursorPosition(
WORD wRow,
WORD wLockType = SQL_LOCK_NO_CHANGE
);
Paramètres
wRow
La position de base 1 d'une ligne dans l'ensemble de lignes actuel. Cette valeur peut varier de 1 à la taille du jeu de lignes.wLockType
Évaluez indiquer comment verrouiller la ligne après sa actualisée. Pour plus d'informations, consultez les notes.
Notes
En implémentant l'extraction de lignes en bloc, les enregistrements sont récupérés par les jeux de lignes, où le premier enregistrement dans le jeu de lignes extrait est l'enregistrement courant. Afin de noter à un autre enregistrement dans le jeu de lignes l'enregistrement actif, appelez SetRowsetCursorPosition. Par exemple, vous pouvez combiner SetRowsetCursorPosition avec la fonction membre de GetFieldValue pour récupérer dynamiquement des données de tout enregistrement du recordset.
Pour utiliser SetRowsetCursorPosition, vous devez avoir implémenté l'extraction de lignes en bloc en spécifiant l'option d' CRecordset::useMultiRowFetch du paramètre d' dwOptions dans la fonction membre d' Ouvrez .
SetRowsetCursorPosition appelle la fonction API ODBC SQLSetPos. Le paramètre d' wLockType spécifie l'état de verrouillage de la ligne après SQLSetPos a exécuté. Le tableau suivant décrit les valeurs possibles pour wLockTypE.
wLockType |
Description |
|---|---|
SQL_LOCK_NO_CHANGE (valeur par défaut) |
Le gestionnaire ou la source de données garantit que la ligne dans la même chose est verrouillée ou l'état déverrouillé tel qu'il était avant qu' SetRowsetCursorPosition a été appelé. |
SQL_LOCK_EXCLUSIVE |
Le gestionnaire ou la source de données verrouille la ligne exclusivement. Toutes les sources de données prennent en charge ce type de verrou. |
SQL_LOCK_UNLOCK |
Le gestionnaire ou la source de données déverrouille la ligne. Toutes les sources de données prennent en charge ce type de verrou. |
Pour plus d'informations sur SQLSetPos, consultez Kit de développement logiciel Windows. Pour plus d'informations sur l'extraction de lignes en bloc, consultez l'article recordset : Extraction globale d'enregistrements (ODBC).
Configuration requise
Header: afxdb.h