CeEnumDBVolumes (CEDB)

9/8/2008

Essa função enumera todos os volumes montados banco de dados e retorna o nome para cada.

Essa função não trabalho com bancos de dados Edb. Para obter mais informações, consulte EDB Functions.

Uma versão RAPI dessa função existe chamado CeEnumDBVolumes (RAPI).

Syntax

BOOL CeEnumDBVolumes( 
  PCEGUID pceguid, 
  LPWSTR lpBuf,
  DWORD dwNumChars
);

Parameters

• pceguid
  [no] Ponteiro para o CEGUID valor retornado por CREATE_INVALIDGUID. Para começar enumeração, defina este parâmetro para o valor ponteiro.

• lpBuf
  [out] Ponteiro para a reserva alocada que recebe os nomes volume banco de dados.

• dwNumChars
  [no] Comprimento, em caracteres, da reserva.

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_INSUFFICIENT_BUFFER	Indica que a reserva especificada não estava grande o suficiente.
ERROR_INVALID_PARAMETER	Indica que um dos parâmetros é inválido.
ERROR_NO_MORE_ITEMS	Indica que há volumes não mais montadas para enumerar.

Remarks

Para enumerar todos os volumes montados, o sistema operacional configura o processo de enumerar todos os volumes banco de dados. Sobre o primeiro bem-sucedido conclusão, pceguid e lpBuf estão definidos para o CEGUID e o nome do primeiro volume banco de dados dos volumes banco de dados, respectivamente.

Para continuar enumeração, chamar CeEnumDBVolumes Com o anteriormente retornado CEGUID e continue até que ocorra um erro. Se o valor de retorno for ERROR_INSUFFICIENT_BUFFER, realocar a reserva e usar o pceguid que foi retornada a partir de falha para continuar a enumeração. Isso evita a necessidade de reinicialização completamente o processo.

Requirements

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

See Also

Reference

CEDB Functions
CREATE_INVALIDGUID