Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CeEnumDBVolumes (RAPI)

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This method enumerates all mounted database volumes on a remote Windows Embedded CE–based device and returns the name for each.


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

pceguid

[in] To begin enumeration, set this parameter to the value returned by CREATE_INVALIDGUID macro

lpBuf

[out] Pointer to the allocated buffer that receives the database volume names.

dwNumChars

[in] Specifies the length, in characters, of the buffer.

Nonzero indicates success. Zero indicates failure. To get extended error information, call CeGetLastError and CeRapiGetError. Possible values for CeGetLastError include the following:

ERROR_INVALID_PARAMETER

One of the parameters is invalid.

ERROR_NO_MORE_ITEMS

There are no more mounted volumes to enumerate.

ERROR_INSUFFICIENT_BUFFER

The specified buffer was not large enough.

To begin enumeration, set the pceguid parameter to the value returned by the CREATE_INVALIDGUID macro.On successful completion, pceguid and lpBuf are set to the CEGUID and the database volume name of the first of the database volume, respectively. To continue enumeration, call IRAPISession::CeEnumDBVolumes and set the pceguid parameter to the value returned by the previous call. Continue until an error occurs.

If the return value is ERROR_INSUFFICIENT_BUFFER, reallocate the buffer and use the pceguid that was returned from the failure to resume the enumeration. This eliminates the need to completely restart the process.

Headerrapi.h
Libraryrapi.lib
Windows Embedded CEWindows CE 3.0 and later
Windows MobilePocket PC 2000 and later, Smartphone 2002 and later

Community Additions

Show:
© 2015 Microsoft