IMLangConvertCharset::Initialize Method

---

Initializes the internal state of the Conversion Object with the specified parameters.

Syntax

HRESULT Initialize(
    UINT uiSrcCodePage,
    UINT uiDstCodePage,
    DWORD dwProperty
);

Parameters

uiSrcCodePage

[in] Unsigned integer that contains the code page identifier of the characters to be converted.

uiDstCodePage

[in] Unsigned integer that contains the code page identifier of the converted characters.

dwProperty

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

Return Value

Returns one of the following values:

S_OK	The conversion engine can perform character conversion based on the specified parameters.
S_FALSE	The specified set of source/destination code pages is not supported.
E_FAIL	The method failed to initialize the conversion engine because of insufficient memory or other problems.

Remarks

A client can reuse a previously created Conversion Object as many times as necessary by reinitializing it with this method.

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

See Also

IMultiLanguage::CreateConvertCharset