CRecordset::SetRowsetCursorPosition
Move o cursor uma linha no conjunto de registros corrente.
void SetRowsetCursorPosition(
WORD wRow,
WORD wLockType = SQL_LOCK_NO_CHANGE
);
Parâmetros
wRow
A com base em um posição de uma linha no conjunto de linhas corrente.Esse valor pode variar de 1 ao dimensionar do conjunto de linhas.wLockType
Valor que indica como bloquear a linha após foi atualizado.Para obter detalhes, consulte comentários.
Comentários
Ao implementar a busca de linha em massa, os registros são recuperados por conjuntos de linhas, onde o primeiro registro no conjunto de linhas buscado é o registro corrente.Para fazer com que outro registro no conjunto de linhas no registro corrente, chame SetRowsetCursorPosition. Por exemplo, você pode agrupar SetRowsetCursorPosition com o GetFieldValuefunção de membro para recuperar os dados dinamicamente de qualquer registro do seu conjunto de registros.
Para usar SetRowsetCursorPosition, tiver implementado a busca de linha em massa, especificando o CRecordset::useMultiRowFetch opção da dwOptions parâmetro na em abertofunção de membro .
SetRowsetCursorPosition chama a função de API do ODBC SQLSetPos.The wLockType parâmetro especifica o estado de bloquear de linha após SQLSetPos foi executada.A tabela a seguir descreve os valores possíveis para wLockType.
wLockType |
Descrição |
|---|---|
SQL_LOCK_NO_CHANGE (o valor padrão) |
A driver ou fonte de dados assegura que a linha está no mesmo estado bloqueado ou desbloqueado sistema autônomo-w sistema autônomo antes de SetRowsetCursorPosition w sistema autônomo chamado. |
SQL_LOCK_EXCLUSIVE |
A driver ou fonte de dados bloqueia exclusivamente a linha.Nem todas as fontes de dados suporta este tipo de bloquear. |
SQL_LOCK_UNLOCK |
A driver ou fonte de dados desbloqueia a linha.Nem todas as fontes de dados suporta este tipo de bloquear. |
Para obter mais informações sobre o SQLSetPos, see the Windows SDK. Para obter mais informações sobre buscar a linha em massa, consulte o artigo conjunto de registros: Buscando os registros em massa (ODBC).
Requisitos
Cabeçalho: afxdb.h