CRecordset::SetRowsetCursorPosition

void SetRowsetCursorPosition (palavrawRow, palavra wLockType = SQL_LOCK_NO_CHANGE);

Parâmetros

wRow

A baseada em um posição de uma linha no conjunto de registros atual. Este valor pode intervalo de 1 para o tamanho do conjunto de linhas.

wLockType

Valor que indica como bloquear a linha após tiver sido atualizado. Para obter detalhes, consulte "Comentários".

Observações

Chame essa função de membro para mover o cursor para uma linha no conjunto de registros atual. Ao implementar em massa linha buscando, registros são recuperados por conjuntos de linhas, onde o primeiro registro no conjunto de linhas extraído é o registro atual. Para fazer um outro registro no conjunto de registros do registro atual, chame SetRowsetCursorPosition. Por exemplo, você pode combinar SetRowsetCursorPosition com a função de membro GetFieldValue para recuperar dinamicamente os dados de qualquer registro de seu conjunto de registros.

Para usar SetRowsetCursorPosition, você deve ter implementado em massa linha buscando, especificando a opção de CRecordset:: useMultiRowFetch do parâmetro dwOptions na função de membro Abrir.

SetRowsetCursorPosition chamadas a função de API de ODBC SQLSetPos. O parâmetro wLockType especifica o estado de bloqueio da linha depois que SQLSetPos tem executado. A tabela a seguir descreve os possíveis valores para wLockType.

wLockType Descrição
SQL_LOCK_NO_CHANGE (o valor padrão) A driver ou origem de dados garante que a linha está no mesmo estado bloqueado ou desbloqueado como estava antes SetRowsetCursorPosition foi chamado.
SQL_LOCK_EXCLUSIVE A driver ou origem de dados bloqueia a linha exclusivamente. Nem todas as fontes de dados oferecem suporte a esse tipo de bloqueio.
SQL_LOCK_UNLOCK A driver ou origem de dados desbloqueia a linha. Nem todas as fontes de dados oferecem suporte a esse tipo de bloqueio.

Para obter mais informações sobre SQLSetPos, consulte o Referência do programador ODBC SDK. Para obter mais informações sobre a linha em massa buscando, consulte o artigo Recordset: Buscar registros em massa (ODBC) no Guia do programador do Visual C++.

Visão geral de CRecordsetMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CRecordset::RefreshRowset, CRecordset::SetRowsetSize

Index