CeEnumDBVolumes (RAPI)
9/8/2008
Este método enumera todos os volumes montados banco de dados um remoto dispositivo baseado em Windows Embedded CE e retorna o nome de cada.
Syntax
BOOL CeEnumDBVolumes (
PCEGUID pceguid,
LPWSTR lpBuf,
DWORD dwNumChars
);
Parameters
- pceguid
[no] Para começar enumeração, defina este parâmetro para o valor retornado por CREATE_INVALIDGUID macro
- lpBuf
[out] Ponteiro para a reserva alocada que recebe os nomes volume banco de dados.
- dwNumChars
[no] Especifica o comprimento, em caracteres, da reserva.
Return Value
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_INVALID_PARAMETER
Um dos parâmetros é inválido.
- ERROR_NO_MORE_ITEMS
Há volumes não mais montadas para enumerar.
- ERROR_INSUFFICIENT_BUFFER
A reserva especificada não era grande o suficiente.
Remarks
Para começar enumeração, defina o pceguid parâmetro para o valor retornado pela CREATE_INVALIDGUID bem-sucedido Macro.On conclusão, pceguid e lpBuf estão definidos para o CEGUID e o nome do primeiro volume banco de dados do volume de banco de dados, respectivamente. Para continuar enumeração, chamar IRAPISession::CeEnumDBVolumes e defina o pceguid parâmetro para o valor retornado pela chamar anterior. Continue até que ocorrerá 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 elimina a necessidade completamente reiniciar o processo.
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 |