CeCreateDatabase (RAPI)

9/8/2008

Essa função cria um novo banco de dados em um remoto dispositivo baseado em Windows Embedded CE.

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.

Observação

Não crie um nome do banco de dados que terminam com um caractere barra invertida "".

• dwDbaseType
  [no] Especifica o identificador tipo 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. Consulte CeFindFirstDatabase para obter detalhes. 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 quatro (CEDB_MAXSORTORDER = 4) sendo o número máximo. Este parâmetro pode ser zero se não pedidos classificar são ativo. Se esse valor é zero e o mecanismo de banco de dados cria uma ordem classificar usar como padrão onde ".propid rgSortSpecs [0] = 0 ", e " [0] rgSortSpecs .dwFlags = CEDB_SORT_GENERICORDER ". Essa é apenas um espaço reservado e não influenciar a ordem inserção dos registros.

Observação

Classificação pedidos maior, em seguida, são CEDB_MAXSORTORDER inválido.

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

Return Value

Identificador de objeto do banco de dados recém-criado — não um identificador para um aberto banco de dados — indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError. Valores possíveis para CeGetLastError Incluir o seguinte:

• ERROR_DISK_FULL
  Armazenar o objeto não contém espaço suficiente para criar o novo banco de dados.

• ERROR_INVALID_PARAMETER
  Foi um parâmetro inválido.

• ERROR_DUP_NAME
  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. Você pode usar a função CeSetDatabaseInfo (RAPI) a alteração a ordem classificar mais tarde.

Observação

Versões anteriores de Windows Embedded CE atribuído objeto identificadores a objetos em outros sistemas arquivo, such as o sistema de arquivos tabela de alocação de arquivos (FAT).Esses identificadores objeto foram garantia ser exclusivo em um volume, mas não entre múltiplo volumes.Eficaz com versão 3.0, apenas objetos em armazenar o objeto tiver válido, exclusivo objeto identificadores e armazenar o objeto é o único volume que pode retornar um objeto identificador.

Requirements

Header	rapi.h
Library	rapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions
CeDeleteDatabase (RAPI)
CeFindFirstDatabase (RAPI)
CeOidGetInfo (RAPI)
CeOpenDatabase (RAPI)
CeSetDatabaseInfo (RAPI)