IMLangConvertCharset::Initialize method

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

Syntax

HRESULT Initialize(
  [in] UINT  uiSrcCodePage,
  [in] UINT  uiDstCodePage,
  [in] DWORD dwProperty
);

Parameters

  • uiSrcCodePage [in]
    An unsigned integer that contains the code page identifier of the characters to be converted.

  • uiDstCodePage [in]
    An unsigned integer that contains the code page identifier of the converted characters.

  • dwProperty [in]
    An 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.

Return code 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

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Mlang.h

IDL

Mlang.idl

DLL

Mlang.dll

See also

IMLangConvertCharset

CreateConvertCharset