CRowset::FindNextRow

Localiza a próxima linha correspondente após o indicador especificado.

HRESULT FindNextRow( 
   DBCOMPAREOP op, 
   BYTE* pData, 
   DBTYPE wType, 
   DBLENGTH nLength, 
   BYTE bPrecision, 
   BYTE bScale, 
   BOOL bSkipCurrent = TRUE, 
   CBookmarkBase* pBookmark = NULL  
) throw( );

Parâmetros

  • op
    [in] A operação para usar na comparação de valores de linha.Para obter valores, consulte IRowsetFind::FindNextRow.

  • pData
    [in] Um ponteiro para o valor a ser correspondido.

  • wType
    [in] Indica o tipo de dados da parte de valor do buffer.Para obter informações sobre indicadores de tipo, consulte Tipos de dados na referência OLE DB Programmer na Windows SDK.

  • nLength
    [in] O comprimento, em bytes, da estrutura de dados do consumidor alocado para o valor de dados.Para obter detalhes, consulte a descrição de cbMaxLen em DBBINDING estruturas na referência OLE DB Programmer.

  • bPrecision
    [in] A precisão máxima usada ao obter dados.Used only if wType is DBTYPE_NUMERIC.Para obter mais informações, consulte conversões envolvendo DBTYPE_NUMERIC ou DBTYPE_DECIMAL na OLE DB Programmer referência.

  • bScale
    [in] A escala usada ao obter dados.Usado somente se wType é DBTYPE_NUMERIC ou DBTYPE_DECIMAL.Para obter mais informações, consulte conversões envolvendo DBTYPE_NUMERIC ou DBTYPE_DECIMAL na OLE DB Programmer referência.

  • bSkipCurrent
    [in] O número de linhas de indicador em que iniciar uma pesquisa.

  • pBookmark
    [in] Indicador de posição em que iniciar uma pesquisa.

Valor de retorno

Um padrão HRESULT.

Comentários

Este método requer a interface opcional IRowsetFind, que pode não ser suportado em todos os provedores; Se esse for o caso, o método retorna E_NOINTERFACE.Você também deve definir DBPROP_IRowsetFind para VARIANT_TRUE antes de chamar Abrir na tabela ou que contém o conjunto de linhas de comando.

Para obter informações sobre como usar indicadores em consumidores, consulte Usando marcadores.

Requisitos

Cabeçalho: atldbcli.h

Consulte também

Referência

Classe CRowset

DBBINDING Structures