Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function retrieves information about all databases of a specified type residing on a remote Windows Embedded CE–based device.

Syntax

BOOL CeFindAllDatabases(
  DWORD 
dwDbaseType, 
  WORD 
wFlags, 
  LPWORD 
cFindData, 
  LPLPCEDB_FIND_DATA 
ppFindData 
); 

Parameters

dwDbaseType

[in] Specifies the type identifier of the databases to seek. This value is application-defined and is set when the database is created using the CeCreateDatabaseand CeCreateDatabaseExfunctions.

wFlags

[in] Members of the CEDB_FIND_DATAstructure that are to be retrieved. This parameter can be a combination of the following values.

Value Description

FAD_OID

Retrieves the OidDbmember.

FAD_FLAGS

Retrieves the DbInfo.dwFlagsmember.

FAD_NAME

Retrieves the DbInfo.szDbaseNamemember.

FAD_TYPE

Retrieves the DbInfo.dwDbaseTypemember.

FAD_NUM_RECORDS

Retrieves the DbInfo.dwNumRecordsmember.

FAD_NUM_SORT_ORDER

Retrieves the DbInfo.dwNumSortOrdermember.

FAD_SORT_SPECS

Retrieves the DbInfo.rgSortSpecsmember.

cFindData

[out] Pointer to a variable that receives a count of the items found.

ppFindData

[out] Pointer to the pointer to an array of CEDB_FIND_DATAstructures that receive information about the found items. It is the application's responsibility to free the memory used by the array. To free the memory the application must call CeRapiFreeBuffer.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call CeGetLastErrorand CeRapiGetError.

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