CeMountDBVol (RAPI)

9/8/2008

Essa função emite uma solicitação de montagem em um remoto Windows Embedded CE Device.for baseado em um volume banco de dados que contém os dados e um log integridade. A função preenche uma reserva com um CEGUID que é a identificador exclusivo (GUID) do volume montado banco de dados.

Syntax

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

Parameters

• pceguid
  [out] Ponteiro para um CEGUID que é definida como a GUID do volume montado banco de dados.

• lpszDBVol
  [no] Ponteiro para o seqüência de caracteres NULL-Terminated 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 como o volume banco de dados é aberto. Ele é um do seguinte sinalizadores.

  Valores	Descrição
  CREATE_NEW	Cria um novo volume banco de dados. A função falhará se o volume banco de dados especificado já existe.
  CREATE_ALWAYS	Cria um novo volume banco de dados. A função substitui o volume banco de dados se ele existir.
  OPEN_EXISTING	Abre o volume banco de dados. A função falhará se o volume banco de dados não existe.
  OPEN_ALWAYS	Abre o volume banco de dados, se ele existir. Se o volume banco de dados não existir, a função criará o volume banco de dados como se CREATE_NEW foi especificado.
  TRUNCATE_EXISTING	Abre o volume banco de dados. Depois que aberto, o volume banco de dados será truncado para que seu tamanho seja zero bytes. A função falhará se o volume banco de dados não existe.

Valores Return

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError. Valores possíveis para CeGetLastError Incluir o seguinte:

• ERROR_DISK_FULL
  O volume montado não tem espaço criar o novo banco de dados.

• ERROR_INVALID_NAME
  O lpszDBVol parâmetro continha um vazio caminho.

• ERROR_PATH_NOT_FOUND
  O lpszDBVol parâmetro continha um inválido caminho.

• ERROR_INVALID_PARAMETER
  Foi um parâmetro inválido.

• ERROR_NOT_ENOUGH_MEMORY
  Não havia memória suficiente disponível para Criar volume.

Se o volume banco de dados já existir antes de chamar função e dwFlags é CREATE_ALWAYS ou OPEN_ALWAYS, CeGetLastError Retorna ERROR_ALREADY_EXISTS, mesmo que a função foi bem-sucedida.

Remarks

O CeMountDBVol função cria um volume banco de dados que contém os dados e um log integridade. A função pode aceitar qualquer caminho incluindo Uniform Naming Convention (UNC) nomes para arquivos em um LAN.

Um volume banco de dados única pode ser montado mais de uma vez por um aplicativo diferente. Cada tempo que o volume está montado, um contagem de referência é incrementado. Não desmontar um volume montado banco de dados até que todos os aplicativos que montada a chamar volume CeUnmountDBVol. CeUnmountDBVol deve ser chamado para livre backup recursos sistema.

Todos os dados gravados em um volume montado banco de dados é armazenado em cache até que ocorra um do seguinte:

• É explicitamente liberado.
• Ele é liberado pela OS devido um baixo-memória condição.
• Ele é desmontado.

CeMountDBVol não é com suporte para placas armazenamento emulada criadas para o Device Emulator através do compartilhamento pasta.

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
CeFlushDBVol (RAPI)
CeUnmountDBVol (RAPI)