CeSetDatabaseInfo (RAPI)

9/8/2008

Essa função define os parâmetros para um banco de dados armazenar o objeto em um remoto dispositivo baseado em Windows Embedded CE. Os parâmetros que podem ser definidos incluem o nome, tipo e classificar-descrições ordem.

Observação

Esse método foi substituído.Uso CeSetDatabaseInfoEx Em vez disso.

Syntax

BOOL CeSetDatabaseInfo(
  CEOID oidDbase, 
  CEDBASEINFO * pNewInfo 
);

Parameters

• oidDbase
  [no] Identificador de objeto do banco de dados para que os parâmetros devem ser definidas.

• pNewInfo
  [no] Ponteiro para um CEDBASEINFO estrutura que contém novas informações parâmetro para o banco de dados. O wNumRecords membro da estrutura não é usado.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError. Valores possíveis para CeGetLastError Incluir o seguinte:

• ERROR_INVALID_PARAMETER
  Foi um parâmetro inválido.

• ERROR_DISK_FULL
  Armazenar o objeto está cheio e quaisquer alterações tamanho exigido não pôde ser acomodados. Alterando pedidos classificar podem alteração de tamanho do armazenado registros, embora não pelo muito.

• ERROR_SHARING_VIOLATION
  CeSetDatabaseInfo (RAPI) tentou remover uma ordem classificar que está sendo usado por um atualmente aberto banco de dados.

Remarks

O CeSetDatabaseInfo função pode ser usada para alteração de parâmetros banco de dados passados em durante a criação de banco de dados. Observe que alterar a ordem classificar do banco de dados pode levar vários minutos. Antes chamado CeSetDatabaseInfo, um aplicativo deve avisar o usuário que esta operação pode ser demorada.

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.

Para obter versões Windows Embedded CE 2.10 através de 2.12, faça não chamar essa função em um aberto banco de dados. Windows Embedded CE versões 3.0 e posterior, os pedidos classificar de um banco de dados não podem ser alterados enquanto um identificador para que banco de dados permanecerá aberto.

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)
CEDBASEINFO
CeOidGetInfo (RAPI)