IRAPISession::CeEnumDBVolumes
This method enumerates all mounted database volumes on a remote Microsoft® Windows® CE–based device and returns the name for each.
BOOL CeEnumDBVolumes (
PCEGUID pceguid,
LPWSTR lpBuf,
DWORD dwNumChars
);
Parameters
- pceguid
[in] To begin enumeration, set this parameter to the value returned by the 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.
Return Values
Nonzero indicates success. Zero indicates failure. To get extended error information, call IRAPISession::CeGetLastError and IRAPISession::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.
Remarks
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.
Requirements
OS Versions: Windows CE 5.01 and later.
Header: Rapi2.h.
Link Library: Ole32.lib, Rapiuuid.lib.
See Also
IRAPISession::IUnknown | IRAPISession::CeMountDBVol
Send Feedback on this topic to the authors