IMLangConvertCharset::Initialize

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Return Value

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.

Remarks

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

Requirements

Header mlang.h, mlang.idl
Library mlang.dll
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later