The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IMultiLanguage2::CreateConvertCharset method

Creates a charset Conversion object and retrieves its corresponding IMLangConvertCharset interface.

Syntax

C++


HRESULT CreateConvertCharset(
  [in]  UINT                 uiSrcCodePage,
  [in]  UINT                 uiDstCodePage,
  [in]  DWORD                dwProperty,
  [out] 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]: 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 value

Returns one of the following values:

Return code	Description
S_OK	Success.
S_FALSE	The object was created but could not be initialized because the specified set of source/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 many repeated character set conversions with the same combination of source/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

Minimum supported client	Windows XP
Minimum supported server	Windows 2000 Server
Header	Mlang.h
IDL	Mlang.idl
DLL	Mlang.dll