IMLangConvertCharset::Initialize (Windows Embedded CE 6.0)

1/6/2010

This method initializes the internal state of the Conversion object with the specified parameters.

Syntax

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

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] Specifies one of the MLCONVCHAR-defined values. This flag indicates how to display unconvertible Unicode characters when performing Unicode-to-multibyte conversion.

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

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

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