CeCreateDatabase (CEDB)

9/8/2008

Essa função cria um novo banco de dados. Essa função é obsoleto. Chamada CeCreateDatabaseEx2 (CEDB) em vez disso.

Uma versão RAPI dessa função existe nomeado CeCreateDatabaseEx (RAPI).

Syntax

CEOID CeCreateDatabase(
  LPWSTR lpszName, 
  DWORD dwDbaseType, 
  WORD wNumSortOrder, 
  SORTORDERSPEC* rgSortSpecs
); 

Parameters

• lpszName
  [no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que especifica o nome para o novo banco de dados. O nome pode ter até 32 caracteres, incluindo a caractere nulo de terminação. Se o nome é muito longo, será truncado, e o banco de dados é criado. Não use um seqüência vazia como a nome do banco de dados.

• dwDbaseType
  [no] Digite identificador para o banco de dados. Este é um application-defined value que pode ser usado para qualquer propósito Application-defined. De exemplo, um aplicativo pode usar o identificador tipo para distinguir dados do catálogo endereço de dados lista de Tarefas ou use o identificador durante uma seqüência enumeração banco de dados. Para obter mais informações, consulte CeFindFirstDatabase (CEDB). Identificador de tipo não serve para ser um identificador exclusivo para o banco de dados. O sistema não usa esse valor.

• wNumSortOrder
  [no] Número de classificar pedidos ativo no banco de dados, com 4 sendo o número máximo. Este parâmetro pode ser definido como zero se há pedidos classificar estiver ativo. Se esse valor for definido para zero, o mecanismo de banco de dados cria uma ordem de classificação usar como padrão no qual .propid rgSortSpecs [0] = 0. Essa é apenas um espaço reservado e não influenciar a ordem inserção dos registros.

• rgSortSpecs
  [no] Ponteiro para uma matriz de real descrições ordem de classificação. O tamanho da matriz especificado pelo wNumSortOrder. Este parâmetro pode ser definido como NULL se wNumSortOrder é zero.

Return Value

Identificador de objeto do banco de dados recém-criado indica sucesso. NULL Indica falha. Para informações de erro estendidas get em um programa, chamar Windows Embedded CE GetLastError. A seguinte tabela lista os valores possíveis.

Valor	Descrição
ERROR_DISK_FULL	Indica que a origem destino não contém espaço suficiente para criar o novo banco de dados.
ERROR_INVALID_PARAMETER	Indica que um parâmetro estava inválido.
ERROR_DUP_NAME	Indica que já existe um banco de dados com o nome especificado.

Remarks

Como classificar pedidos aumentam os recursos de sistema necessários para executar cada inserir e excluir operação, manter o número de classificar Pedidos em um nível mínimo. Use a função CeSetDatabaseInfo (CEDB) a alteração a ordem classificar mais tarde.

Requirements

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

See Also

Reference

CEDB Functions
CeCreateDatabaseEx (CEDB)
CeCreateDatabaseEx2 (CEDB)
CeDeleteDatabaseEx (CEDB)
CeOidGetInfoEx (CEDB)
CeOpenDatabaseEx (CEDB)
CeSetDatabaseInfoEx (CEDB)
SORTORDERSPEC (CEDB)