CeSetDatabaseInfoEx (RAPI)

9/8/2008

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

Syntax

BOOL CeSetDatabaseInfoEx( 
  PCEGUID pceguid, 
  CEOID oidDbase,
  CEDBASEINFO * pNewInfo 
);

Parameters

• pceguid
  [no] Ponteiro para o CEGUID que contém a identificador exclusivo (GUID) de um banco de dados montado.

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

Valores Return

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
  O objeto armazenar ou volume montado está cheio e quaisquer alterações tamanho exigido não pôde ser acomodados. Alterando pedidos classificar podem minimamente alteração o tamanho dos registros armazenados.

• ERROR_SHARING_VIOLATION
  O CeSetDatabaseInfoEx função tentou remover uma ordem classificar que está sendo usado por um atualmente aberto banco de dados.

Remarks

Uso CeSetDatabaseInfoEx a alteração de parâmetros banco de dados passados em durante a criação de banco de dados. Alterar a ordem classificar ou compactação de um banco de dados é uma operação muito cara, possivelmente levando minutos a few. Antes chamado essa função, avisar o usuário que este é um processo demorado. Windows CE 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.

Alterar a compactação de um banco de dados afeta registros apenas novos e modificados.

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