CeSetDatabaseInfoEx2 (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 não trabalho com bancos de dados Edb. Para obter mais informações, consulte EDB Functions.

Syntax

BOOL CeSetDatabaseInfoEx2( 
  PCEGUID pguid, 
  CEOID oidDbase,
  CEDBASEINFOEX* pNewInfo
);

Parameters

• pguid
  [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 CEDBASEINFOEX (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_INVALID_PARAMETER	Indica que um parâmetro estava inválido.
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_SHARING_VIOLATION	Indica que essa função tentou remover uma ordem classificar que está sendo usado por um atualmente aberto banco de dados. Windows CE 3.0 e posterior, indica que essa função foi chamado em um aberto banco de dados.

Remarks

Os pedidos classificar de um banco de dados não podem ser alterados enquanto um identificador para que banco de dados permanecerá aberto.

Use esta função para alteração de parâmetros banco de dados passados em durante a criação de banco de dados.

Se você tentar alteração a ordem de classificação banco de dados para classificar em não-NULL chaves propriedades OU exclusivo, a alteração pode falhar porque os registros existentes não satisfaçam esses novos requisitos. O banco de dados retém sua original informações. Erro ERROR_ACCESS_DENIED Retorna se uma não-NULL requisito não for satisfeito e existe um erro ERROR_ALREADY_EXISTS se um chaves não-exclusivo. Processar uma falha causada por um ERROR_ALREADY_EXISTS é potencialmente muito lento e deve ser evitado.

Se a chave banco de dados é restrito a ser exclusivo, todos os registros são exigido para que todas as propriedades classificar. A adição de um exclusivo restrição adiciona não-NULL requisitos para todas as propriedades classificar. 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.

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 CEDBASEINFOEX (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 .NET 4.0 and later

See Also

Reference

CEDB Functions
CeCreateDatabaseEx2 (CEDB)
CEDBASEINFOEX (CEDB)
CeOidGetInfoEx2 (CEDB)
CREATE_SYSTEMGUID