CEDBASEINFO (CEDB)

9/8/2008

Essa estrutura contém informações sobre um objeto de banco de dados. Essa estrutura é usada pelo CeSetDatabaseInfoEx2 (CEDB) e o CeCreateDatabaseEx2 (CEDB) funções.

Syntax

typedef struct _CEDBASEINFO {
  DWORD dwFlags; 
  WCHAR szDbaseName[CEDB_MAXDBASENAMELEN];
  DWORD dwDbaseType;
  WORD wNumRecords;
  WORD wNumSortOrder;
  DWORD dwSize;
  FILETIME ftLastModified;
  SORTORDERSPEC rgSortSpecs[CEDB_MAXSORTORDER];
} CEDBASEINFO;

Os membros

• dwFlags
  Pode ser definido como um ou uma combinação de valores. A seguinte tabela mostra os valores possíveis.

  Sinalizador	Descrição
  CEDB_VALIDDBFLAGS	Indica se o estendido CEDB_NOCOMPRESS e CEDB_SYSTEMDB sinalizadores estão sendo alterados.
  CEDB_VALIDMODTIME	Indica que o ftLastModified membro é válido e deve ser usado.
  CEDB_VALIDNAME	Indica que o szDbaseName membro é válido e deve ser usado.
  CEDB_VALIDSORTSPEC	Indica que o rgSortSpecs membro é válido e deve ser usado.
  CEDB_VALIDTYPE	Indica que o dwDbaseType membro é válido e deve ser usado.

  A seguinte tabela mostra o estendido possíveis valores sinalizador.

  Sinalizador estendido	Descrição
  CEDB_NOCOMPRESS	Indica que o banco de dados não é compactado. Se este sinalizador for usado com CeSetDatabaseInfoEx2, registros novos ou modificados em um banco de dados compactados são descompactados. Se este sinalizador for usado com CeCreateDatabaseEx2, o banco de dados não é compactado. Por padrão, todos os bancos de dados são compactados. Se você pretende alteração a compactação, isso em hora da criação.
  CEDB_SYSTEMDB	Indica que o banco de dados está marcado como um banco de dados sistema e não podem ser excluído por um sem privilégios aplicativo. Um sem privilégios aplicativo não é possível fazer o seguinte API chamadas em um sistema arquivo de banco de dados: CeCreateDatabaseEx2, CeSetDatabaseInfoEx2, ou CeDeleteDatabase.

• szDbaseName
  Seqüência de caracteres NULL-Terminated que contém o nome do banco de dados. O seqüência de caracteres podem ter até 32 caracteres, incluindo a caractere nulo de terminação. Este membro deve ser definido quando usado para CeCreateDatabaseEx2.

• dwDbaseType
  Digite identificador para o banco de dados.

• wNumRecords
  Número de registros o banco de dados.

• wNumSortOrder
  Número de classificar pedidos ativo no banco de dados. Up to classificar quatro Pedidos podem ser ativo em um tempo.

• dwSize
  Tamanho do banco de dados, em bytes.

• ftLastModified
  Último tempo este banco de dados foi modificado.

• rgSortSpecs
  Matriz que contém as descrições ordem de classificação. Somente o primeiro n matriz membros são válido, onde n é o valor especificado pelo wNumSortOrder membro. Se nenhum pedidos classificar forem especificados para CeCreateDatabaseEx2 Ou quando CEDB_VALIDSORTSPEC não for especificado, uma ordem classificar usar como padrão está atribuído para o banco de dados.

Remarks

Windows CE 2.10 e posterior, dwFlags possui significado adicional, mas ainda é compatível com versões anteriores. O alto-Palavra de ordem dwFlags Especifica as propriedades adicionais banco de dados.

CeSetDatabaseInfoEx2 e a função CeOidGetInfoEx2 (CEDB) pode usar todos os dwFlags Sinalizadores. CeCreateDatabaseEx2 Usa apenas os sinalizadores CEDB_VALIDDBFLAGS, CEDB_NOCOMPRESS e CEDB_SYSTEMDB. Usando outros sinalizadores com CeCreateDatabaseEx2 é ignorado.

Se você tentar alteração de informações para um banco de dados existente usando a função CeSetDatabaseInfoEx (CEDB) e transmitir o sinalizador CEDB_VALIDNAME in dwFlags, você receber uma mensagem de 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
Windows Embedded CE	Windows CE 1.01 and later

See Also

Reference

CEDB Structures
CeSetDatabaseInfoEx2 (CEDB)
CeSetDatabaseInfoEx2 (CEDB)
CEOIDINFO (CEDB)
CeOidGetInfoEx2 (CEDB)