CeChangeDatabaseLCID (CEDB)

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This function changes the locale identifier (LCID) of a database volume for sort operations.

Syntax

VOID CeChangeDatabaseLCID( 
  PCEGUID pceguid, 
  DWORD LCID 
);

Parameters

  • pceguid
    [in] Pointer to a CEGUID identifier that identifies a mounted database volume to which the LCID is applied. If pceguid points to the system GUID value, the object store is used as the database volume.
  • LCID
    [in] Locale identifier to apply to the database volume.

Return Value

None.

Remarks

When you create a database volume, the volume receives the default system LCID; that is, the database volume LCID is set to zero, and the LCID becomes the criteria by which string values for sorting can be compared. Data that exists in the database is sorted using this system LCID. Similarly, database actions that depend on sort order, such as adding a record, depend on the LCID.

If you change the system LCID after creating a database volume, you must also use this function to 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.

Requirements

Header pwindbas.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later

See Also

Reference

CEDB Functions
CREATE_SYSTEMGUID
CREATE_INVALIDGUID

Other Resources

GetLocaleInfo
GetSystemDefaultLCID
GetUserDefaultLCID