IMultiLanguage::EnumCodePages method

Creates a Code Page Enumeration Object, initializes it with the value specified with grfFlags, and gets the corresponding IEnumCodePage interface.

Syntax

HRESULT EnumCodePages(
  [in]  DWORD         grfFlags,
  [out] IEnumCodePage **ppEnumCodePage
);

Parameters

• grfFlags [in]
  A flag that specifies the possible uses for a code page. This parameter is used to control code page enumeration. This must be a combination of the MIMECONTF constant values.

• ppEnumCodePage [out]
  The address of a buffer that receives an IEnumCodePage interface.

Return value

Returns NOERROR if successful, or E_OUTOFMEMORY if the attempt to create the object fails.

Remarks

A client uses this method to collect code page information for all the code pages in the MIME database. Through the IEnumCodePage interface, a client can create an array of MIMECPINFO structures, which contain detailed information about the code pages in the MIME database that the grfFlags parameter applies to.

Although the IEnumCodePage interface is retrieved through this method, the caller is responsible for releasing it when it is no longer needed.

Requirements

See also

IMultiLanguage

IMultiLanguage::EnumRfc1766