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 changes the locale identifier (LCID) of a volume for sort operations.

Syntax

VOID CeChangeDatabaseLCID(
  PCEGUID 
pGuid, 
  DWORD 
lcid
);

Parameters

pGuid

[in] CEGUID of the mounted volume to which the LCID is applied.

lcid

[in] Locale identifier to apply to the database volume.

Return Value

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError. The following table shows possible values.

Return Value Description

ERROR_INVALID_PARAMETER

The pGuidparameter is set to NULL, or lcidis not valid.

ERROR_NOT_FOUND

The volume specified by pGuiddoes not exist.

ERROR_SHARING_VIOLATION

The LCID can only be changed if the volume is mounted once. This error may occur if there is an open handle on any database in the volume.

Remarks

This function rebuilds all sort orders on all databases in the volume. This can potentially be very time-consuming.

When you create a database volume, the volume receives the default system LCID. The database volume LCID is set to zero, and the LCID becomes the criterion for comparing string values.

If you change the system LCID after creating a database volume, you must also use CeChangeDatabaseLCIDto change the database LCID and re-sort the existing data. Otherwise, problems can occur when the database attempts to find or add new data based on the new LCID, but the existing data is sorted using the old system LCID.

If any database in the volume has an open handle, this function fails with ERROR_SHARING_VIOLATION.

There are no differences between this function and the CEDB equivalent function.

Requirements

Header windbase.h
Library coredll.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

EDB Functions