CeSetDatabaseInfo (CEDB)

9/8/2008

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

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

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 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 a armazenar objeto está cheio e quaisquer alterações tamanho exigido não pôde ser acomodados. Alterando pedidos classificar podem alteração o tamanho dos registros armazenados, mas somente por uma quantidade pequena.
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

Esta função pode ser usada para alteração de parâmetros banco de dados passados em durante a criação de banco de dados. Alterando a ordem classificar do banco de dados pode levar vários minutos. Antes chamado essa função, avisar o usuário que esta operação pode ser demorada.

Para obter Windows CE 2.10 através de 2.12, faça não chamar essa função em um aberto banco de dados. 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.

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 1.01 and later

See Also

Reference

CEDB Functions
CeCreateDatabase (CEDB)
CeOidGetInfo (CEDB)
CEDBASEINFO (CEDB)
CeSetDatabaseInfoEx2 (CEDB)