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 |