IMultiLanguage2::CreateConvertCharset

This method creates a charset Conversion object and retrieves its corresponding IMLangConvertCharset interface.

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 a pointer to the buffer where the client will receive an IMLangConvertCharset interface.

Return Values

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 IMLangConvertCharset interface is retrieved through this method, the caller is still responsible for releasing it when it is no longer needed.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Mlang.h, Mlang.idl.
Link Library: Mlang.dll.

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.