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 method creates a charset Conversionobject and retrieves its corresponding IMLangConvertCharsetinterface.

Syntax 

HRESULT CreateConvertCharset( 
  UINT 
uiSrcCodePage,
  UINT 
uiDstCodePage,
  DWORD 
dwProperty,
  IMLangConvertCharset** 
ppMLangConvertCharset
);

Parameters

uiSrcCodePage

[in] Code page identifier value for the source character stream to which the caller wants the Conversion object dedicated.

uiDstCodePage

[in] Code page identifier value for the destination character stream to which the caller wants the Conversion object dedicated.

dwProperty

[in] Specifies one of the MLCONVCHAR-defined values. This flag indicates how to display unconvertible Unicode characters when performing Unicode-to-multibyte conversion.

ppMLangConvertCharset

[out] Address of the buffer where the client will receive an IMLangConvertCharsetinterface.

Return Value

The following table shows the possible return values for this method.

Value Description

S_OK

Success.

S_FALSE

The object was created but could not be initialized because the specified set of source and destination code pages is not supported.

E_FAIL

The method failed to create an instance of the object.

Remarks

A client should use the Conversion object to perform repeated character set conversions with the same combination of source and destination code pages.

Although the IMLangConvertCharsetinterface is retrieved through this method, the caller is still responsible for releasing it when it is no longer needed.

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