IMultiLanguage2::CreateConvertCharset Method

---

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

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] 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 IMLangConvertCharset interface.

Return Value

Returns one of the following values:

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.