CRecordset::SetRowsetCursorPosition

Artigo
08/25/2010

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).