CeFindAllDatabases (RAPI)

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.

This function retrieves information about all databases of a given type residing on the Windows CE device. The function copies information to an array of CEDB_FIND_DATAstructures.

CeFindAllDatabasesis a remote application interface (RAPI), which enables an application running on a desktop computer to make function calls on a Windows CE–based device.

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

Parameters

dwDbaseType

[in] Specifies the type identifier of the databases to seek.

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 receives 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 Values

TRUE indicates success. FALSE indicates failure. To determine if a function failed because of RAPI errors, call CeRapiGetError. To determine if a function failed because of non-RAPI errors, call CeGetLastError.

Remarks

When writing applications for Windows CE versions 1.0 and 1.01, use the PegFindAllDatabasesfunction.

Requirements

Runs On	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Rapi.h