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

See Also

Reference

RAPI Functions