CeSetDatabaseInfoEx (CEDB)

9/8/2008

Essa função Configura parâmetros banco de dados, incluindo o nome, tipo, classificar-descrições ordem e compactação do banco de dados. Essa função é obsoleto. Chame a função CeSetDatabaseInfoEx2 (CEDB) em vez disso.

Uma versão RAPI dessa função existe chamado CeSetDatabaseInfoEx (RAPI).

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 volume montado banco de dados ou de armazenar o objeto. Use a macro CREATE_SYSTEMGUID para obter a GUID de armazenar o objeto.

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

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

Return Value

TRUE indica sucesso. FALSE indica falha. Para informações de erro estendidas get, chamar GetLastError. A seguinte tabela lista os valores possíveis.

Valor	Descrição
ERROR_DISK_FULL	Indica que o objeto armazenar ou volume montado está completo, e qualquer exigido alterações tamanho não pôde ser acomodados. Alterando pedidos classificar podem minimamente alteração o tamanho dos registros armazenados.
ERROR_INVALID_PARAMETER	Indica que um parâmetro estava inválido.
ERROR_SHARING_VIOLATION	Indica que essa função tentou remover uma ordem classificar que está sendo usado por um atualmente aberto banco de dados.

Remarks

Use esta função para 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. Não é possível alteração a ordem classificar se alguém tiver este arquivo aberto.

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.

Se você tentar alteração de informações para um banco de dados existente e transmitir o sinalizador CEDB_VALIDNAME in a dwFlags membro da estrutura CEDBASEINFO (CEDB), você recebe uma erro informando que há um banco de dados existente com esse nome. Se você não fizer isso desejar para alteração de nome do banco de dados, não defina o sinalizador CEDB_VALIDNAME. Somente os sinalizadores para os parâmetros que estão mudando devem ser definidos. Para os parâmetros que não estão alterando, não defina o correspondente sinalizador CEDB_VALID*.

Requirements

Header	windbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 2.10 and later

See Also

Reference

CEDB Functions
CeCreateDatabaseEx (CEDB)
CeOidGetInfoEx (CEDB)
CEDBASEINFO (CEDB)
CREATE_SYSTEMGUID
CeSetDatabaseInfoEx2 (CEDB)