CeRemoveDatabaseProps (EDB)

9/8/2008

Essa função remove as propriedades de um banco de dados.

Essa função não trabalho com bancos de dados CEDB. Para obter mais informações sobre CEDB, consulte CEDB Reference.

Syntax

BOOL CeRemoveDatabaseProps(
  PCEGUID pGuid,
  CEOID oidDb,
  DWORD cProps,
  CEPROPID* prgProps
);

Parameters

• pGuid
  [no] CEGUID do volume montado na qual o banco de dados identificados pela oidDb parâmetro reside. Você pode montar um volume com a função CeMountDBVolEx (EDB).

• oidDb
  [no] OID do banco de dados a partir da qual remover as identificações de propriedade. Esta banco de dados devem existir no volume especificado por pGuid. Esta OID deve tiverem sido gerada pela função CeCreateDatabaseWithProps (EDB).

• cProps
  [no] Número de identificações de propriedade na prgProps matriz.

• prgProps
  [no] Matriz de propriedade identificações para remover a partir de banco de dados.

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.

Return valor	Descrição
ERROR_ACCESS_DENIED	A propriedade faz parte de um ativo ordem classificar.
ERROR_INVALID_PARAMETER	Indica um do seguinte: O pGuid parâmetro for definido como NULL. O oidDb parâmetro for definido como NULL. O cProps parâmetro está definido como zero. O prgProps parâmetro for definido como NULL. Um das identificações propriedade na prgProps matriz tem um inválido CEVT_xxx tipo de dados.
ERROR_NOT_ENOUGH_MEMORY	Não há memória suficiente para a ação completo.
ERROR_NOT_FOUND	Indica um do seguinte: O volume especificado por pGuid não existe. O banco de dados especificado por oidDb Não existe no volume especificado. Um da propriedade identificações especificado na prgProps matriz não consta de banco de dados.
ERROR_SHARING_VIOLATION	Outro segmento tem atualmente o aberto banco de dados.

Remarks

Se não existem propriedades em um banco de dados que não são mais usadas, você poderá usar essa função para remover essas propriedades e limpar o banco de dados, potencialmente resultando em uma redução tamanho volume.

Essa função é bem-sucedida somente se o banco de dados não estiver aberto e a propriedade não é parte de um ativo ordem classificar.

Propriedades são adicionadas a um banco de dados com a função CeAddDatabaseProps (EDB).

Requirements

Header	windbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 5.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

EDB Functions
CeMountDBVolEx (EDB)
CeCreateDatabaseWithProps (EDB)
CEPROPSPEC (EDB)
CeAddDatabaseProps (EDB)

Concepts

EDB Schema Support