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 interface converts a string from one code page to another. This interface is not supported on all Windows Embedded CE-based operating systems. See the SDK documentation specific to your target device to see whether this functionality is supported.

When to Use

A caller uses this interface to repeatedly perform character set conversions involving the same combination of source and destination code pages. This interface can also be used to reinitialize the Conversionobject with new source and destination code pages as many times as necessary.

Methods

The following table shows the methods for this interface in alphabetical order. Like all COM interfaces, this interface inherits the methods for the IUnknowninterface.

Method Description

DoConversion

Converts the given string from the source code page of the Conversion object to its destination code page.

DoConversionFromUnicode

Converts the given wide-character string from Unicode to the destination code page of the Conversion object.

DoConversionToUnicode

Converts the given string from the source multibyte code page of the Conversion object to the Unicode character set.

GetDestinationCodePage

Retrieves the identifier value of the destination code page of the Conversion object.

GetProperty

Retrieves the MLCONVCHAR constants that the Conversion object has set.

GetSourceCodePage

Retrieves the code page identifier value that has been designated as the source code page of the Conversion object.

Initialize

Initializes the internal state of the Conversion object with the specified parameters.

Remarks

A client creates an instance of the Conversion object by using the IMultiLanguage::CreateConvertCharsetmethod. The methods for the IMLangConvertCharsetinterface perform more efficient character set conversions than the methods for the IMultiLanguageinterface.

Requirements

Header mlang.h, mlang.idl
Library mlang.dll
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later