CeSeekDatabase (RAPI)

9/8/2008

Essa função procura o registro especificado em um aberto banco de dados em um remoto dispositivo baseado em Windows Embedded CE.

Syntax

CEOID CeSeekDatabase(
  HANDLE hDatabase, 
  DWORD dwSeekType, 
  DWORD dwValue, 
  LPDWORD lpdwIndex 
);

Parameters

• hDatabase
  [no] Identificador para o aberto banco de dados no qual buscar o registro.

• dwSeekType
  [no] Especifica o tipo de operação buscar para executar. É um dos valores a seguinte tabela.

  Valor	Descrição
  CEDB_SEEK_CEOID	Busca até encontrar um objeto que tenha o identificador objeto especificado. O dwValue parâmetro especifica o identificador objeto. Esse tipo de operação buscar é muito eficiente.
  CEDB_SEEK_VALUESMALLER	Iniciando a partir de atual posição, procura com versões anteriores em direção a iniciar da classificar. Sempre procura com versões anteriores, regardless of ordem classificar. Ordem crescente, isso localiza o maior valor menor do que o valor especificado; em ordem decrescente, isso localiza o menor valor maior do que o valor especificado. Se nenhum dos registros anteriores tem um valor que atenda aos critérios pesquisa, o ponteiro buscar for deixado no final de banco de dados e a função retornará 0. O dwValue parâmetro é um ponteiro para um CEPROPVAL estrutura.
  CEDB_SEEK_VALUEFIRSTEQUAL	Começa na iniciar da classificar e procura ENC até localizar o primeiro valor que é igual ao valor especificado. Sempre procura ENC, regardless of ordem classificar. Se a operação de pesquisa falhar, o ponteiro buscar for deixado no final de banco de dados, e a função retornará 0. O dwValue parâmetro é um ponteiro para um CEPROPVAL estrutura.
  CEDB_SEEK_VALUENEXTEQUAL	Iniciando a partir de atual posição buscar, procura exatamente uma posição ENC na ordem classificado e verifica se o próximo registro é igual valor para o valor especificado. Em caso afirmativo, retorna o identificador deste objeto próximo registro; caso contrário, retorna 0 e deixa o ponteiro de busca ao final de banco de dados. Esta operação pode ser usada em conjunto com a operação CEDB_SEEK_VALUEFIRSTEQUAL para enumerar todos os registros com um valor igual. O dwValue parâmetro é um ponteiro para um CEPROPVAL estrutura.
  CEDB_SEEK_VALUEGREATER	Iniciando a partir de atual posição, procura com versões anteriores em direção a iniciar da classificar. Sempre procura ENC, regardless of ordem classificar. Isso localiza o menor valor maior do que o valor especificado; ordem crescente em ordem decrescente Isso localiza o maior valor menor do que o valor especificado. Se nenhuma do seguinte registros possui um valor que atenda aos critérios pesquisa, o ponteiro buscar for deixado no final de banco de dados e a função retornará 0. O dwValue parâmetro é um ponteiro para um CEPROPVAL estrutura.
  CEDB_SEEK_BEGINNING	Procura até localizar o registro na posição especificada desde o início do banco de dados. O dwValue parâmetro especifica o número de registros a buscar a partir do início.
  CEDB_SEEK_CURRENT	Procura com versões anteriores ou ENC a partir de atual posição do ponteiro de Busca para o número especificado de registros. O dwValue parâmetro especifica o número de registros a buscar a partir de atual posição. A função procura ENC se dwValue é um valor positivo ou negativo com versões anteriores se ele for.
  CEDB_SEEK_END	Procura com versões anteriores para o número especificado de registros do final do banco de dados. O dwValue parâmetro especifica o número de registros a buscar a partir do final.

• dwValue
  [no] Especifica o valor a ser usado para a operação de busca. O significado deste parâmetro depende de como o valor de dwSeekType.

• lpdwIndex
  [out] Ponteiro para uma variável que recebe o índice da iniciar do banco de dados para o início do registro que foi encontrado. Este parâmetro pode ser NULL.

Observação

Passando um não-NULL valor para lpdwIndex irá causar o chamar ser mais lenta e deve ser evitada sempre que possível.

Return Value

O identificador de objeto do registro em que termina a busca indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError. CeGetLastError pode retornar ERROR_INVALID_PARAMETER se é um parâmetro inválido.

Remarks

O CeSeekDatabase método sempre usa o atual ordem classificar do banco de dados.

Se a banco de dados foi aberto usando CeOpenDatabase e o sinalizador CEDB_AUTOINCREMENT foi especificado para o dwFlags parâmetro, o ponteiro banco de dados é incrementado por um registro com cada operação de leitura que ocorre no banco de dados.

Observe que uma busca somente pode ser executada em um valor da propriedade classificada. Depois de criar um usando banco de dados CeCreateDatabaseEx e abrindo o usando banco de dados CeOpenDatabaseEx, chamadas subseqüentes para CeSeekDatabase Assumir a ordem classificar que foi especificado na Propid parâmetro do chamar para CeOpenDatabaseEx.

Para usar um valor negativo para a maiúsculas e minúsculas CEDB_SEEK_CURRENT, CAST um valor long assinado para uma DWORD. Isso altera o intervalo eficaz em índices de registro para BITS 31 de 32.

Classificar vários pedidos não podem ser especificados para uma única propriedade.

Quando um CEPROPVAL estrutura é exigido para buscar, o Propid parâmetro deve ser definido como propid do ordem de classificação especificado na CeOpenDatabaseEx chamar.

Observação

Versões anteriores de Windows Embedded CE atribuído objeto identificadores a objetos em outros sistemas arquivo, such as o sistema de arquivos tabela de alocação de arquivos (FAT).Esses identificadores objeto foram garantia ser exclusivo em um volume, mas não entre múltiplo volumes.Eficaz com versão 3.0, apenas objetos em armazenar o objeto tiver válido, exclusivo objeto identificadores e armazenar o objeto é o único volume que pode retornar um objeto identificador.

Requirements

Header	rapi.h
Library	rapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions
CeCreateDatabase (RAPI)
CeOpenDatabase (RAPI)
CeWriteRecordProps (RAPI)
CEPROPVAL