CeFindAllDatabases
The CeFindAllDatabases function is a RAPI function that 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_DATA structures.
Syntax
BOOL CeFindAllDatabases(DWORD dwDbaseType, WORD wFlags, LPWORD cFindData, LPLPCEDB_FIND_DATA ppFindData);
At a Glance
Header file: |
Rapi.h |
Platforms: |
H/PC |
Windows CE versions: |
2.0 and later |
Parameters
- dwDbaseType
- Type identifier of the databases to seek.
- wFlags
- Members of the CEDB_FIND_DATA structure that are to be retrieved. This parameter can be a combination of the following values:
- FAD_OID
- Retrieve the OidDb member.
- FAD_FLAGS
- Retrieve the DbInfo.dwFlags member.
- FAD_NAME
- Retrieve the DbInfo.szDbaseName member.
- FAD_TYPE
- Retrieve the DbInfo.dwDbaseType member.
- FAD_NUM_RECORDS
- Retrieve the DbInfo.dwNumRecords member.
- FAD_NUM_SORT_ORDER
- Retrieve the DbInfo.dwNumSortOrder member.
- FAD_SORT_SPECS
- Retrieve the DbInfo.rgSortSpecs member.
- cFindData
- Pointer to a variable that receives a count of the items found.
- ppFindData
- Pointer to the address of an array of CEDB_FIND_DATA structures 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
Returns TRUE if successful or FALSE otherwise.
Remarks
When writing applications for Windows CE versions 1.0 and 1.01, use the PegFindAllDatabases function.
For more information about using RAPI functions, see Invoking Functions from a Desktop Computer.