CeMountDBVol (EDB)

9/8/2008

Essa função monta um volume. Essa função é obsoleto. Use a função CeMountDBVolEx (EDB).

Syntax

BOOL CeMountDBVol( 
  PCEGUID pceguid, 
  LPWSTR lpszDBVol,
  DWORD dwFlags
);

Parameters

• pceguid
  [out] Ponteiro para uma reserva que é preenchida in with o CEGUID de um banco de dados montado.

• lpszDBVol
  [no] Ponteiro para o NULL-finalizada seqüência de caracteres que contém o nome arquivo de volume de banco de dados a ser montada. O caminho é limitado a caracteres MAX_PATH e inclui o NULL caractere.

• dwFlags
  [no] Especificação para abrir o volume banco de dados. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  CREATE_ALWAYS	Cria um novo volume banco de dados. Essa função substitui o volume banco de dados se ele existir.
  CREATE_NEW	Cria um novo volume banco de dados. Essa função falhará se o volume banco de dados especificado já existe.
  EDB_MOUNT_FLAG	Quando definido, indica que uma montagem banco de dados edb está ocorrendo. Quando esse sinalizador é definida, essa função tem o mesmo efeito como a função CeMountDBVolEx (EDB) com um NULL pOptions parâmetro.
  OPEN_ALWAYS	Abre o volume banco de dados se ela existir. Se o volume banco de dados não existir, a função criará o volume banco de dados como se CREATE_NEW foram especificados.
  OPEN_EXISTING	Abre o volume banco de dados. A função falhará se o volume banco de dados não existe.
  TRUNCATE_EXISTING	Exclui todos os dados sobre o volume, incluindo bancos de dados e registros e redefine o identificador localidade volume (LCID). Isso tem o mesmo resultado que chamado a função DeleteFile em um volume e, em seguida, chamado CeMountDBVol (Edb) com o sinalizador CREATE_NEW definido. O volume especificado não deve ser montado por um aplicativo ou um acessar negado erro ocorre.

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_ACCESS_DENIED	O dwFlags parâmetro está definido como CREATE_ALWAYS ou TRUNCATE_EXISTING, e um volume banco de dados com o nome especificado no momento está montado. Este erro também é retornado se o nome arquivo refere-se para um arquivo que não seja um válido volume banco de dados.
ERROR_ALREADY_EXISTS	O dwFlags parâmetro está definido como CREATE_NEW, e um volume banco de dados com o nome especificado já existe. Esse erro também é retornado se um volume banco de dados com o CEGUID especificado já está montado.
ERROR_DISK_FULL	O volume montado não tem espaço suficiente criar o novo banco de dados.
ERROR_NOT_ENOUGH_MEMORY	Não há memória suficiente disponível para criar o volume. Se o volume banco de dados já existir e dwFlags é definido como CREATE_ALWAYS ou OPEN_ALWAYS, GetLastError Retorna ERROR_ALREADY_EXISTS, mesmo através de função foi bem-sucedida.
ERROR_PATH_NOT_FOUND	O caminho especificado não foi encontrado.

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)
CeMountDBVol (CEDB)