CRecordset::SetRowsetCursorPosition
Move o cursor para uma linha dentro de rowset atual.
void SetRowsetCursorPosition(
WORD wRow,
WORD wLockType = SQL_LOCK_NO_CHANGE
);
Parâmetros
wRow
A posição baseado em um de uma linha no rowset atual.Esse valor pode variar de 1 ao tamanho do rowset.wLockType
Avalie indicar como bloquear a linha após foi atualizado.Para obter detalhes, consulte comentários.
Comentários
A o implementar a linha em massa que pesquisa, registros são recuperados por rowsets, onde o primeiro registro no rowset procurado for o registro atual.Para tornar um registro para outro registro no rowset atual, chame SetRowsetCursorPosition.Por exemplo, você pode combinar SetRowsetCursorPosition com a função de membro de GetFieldValue para recuperar dinamicamente os dados de qualquer registro do conjunto de registros.
Para usar SetRowsetCursorPosition, você deve ter implementado a linha em massa que pesquisa especificando a opção de CRecordset::useMultiRowFetch de parâmetro de dwOptions na função de membro de Abrir .
SetRowsetCursorPosition chama a função da API SQLSetPosODBC.O parâmetro de wLockType especifica o estado de bloqueio de linha após SQLSetPos executar.A tabela a seguir descreve os valores possíveis para wLockTypE.
wLockType |
Descrição |
|---|---|
SQL_LOCK_NO_CHANGE (o valor padrão) |
O driver ou a fonte de dados asseguraram-se da linha que está bloqueado no estado ou desbloqueado mesmo como era antes que SetRowsetCursorPosition foi chamado. |
SQL_LOCK_EXCLUSIVE |
O driver ou a fonte de dados apenas exclusivamente a linha.Nem todas as fontes de dados oferecem suporte a esse tipo de bloqueio. |
SQL_LOCK_UNLOCK |
o driver ou a fonte de dados desbloqueam a linha.Nem todas as fontes de dados oferecem suporte a esse tipo de bloqueio. |
Para obter mais informações sobre SQLSetPos, consulte Windows SDK.Para obter mais informações sobre a linha em massa que pesquisa, consulte o artigo conjunto de registros: Para buscar registros em massa (ODBC).
Requisitos
Cabeçalho: afxdb.h