Compartilhar via


IMLangConvertCharset

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 Conversion object 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 IUnknown interface.

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::CreateConvertCharset method. The methods for the IMLangConvertCharset interface perform more efficient character set conversions than the methods for the IMultiLanguage interface.

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