IEnumCodePage  Interface

IID_IEnumCodePage

{275C23E3-3747-11D0-9FEA-00AA003F8646}

A client uses this interface to obtain information about many code pages at once or to determine which code pages fit a certain flag.

Remarks

A client can use this interface to retrieve an array of MIMECPINFO structures, which contain detailed information about a given code page.

 

When calling IMultiLanguage::EnumCodePages to initialize IEnumCodePage, the client may set one or more of the flags defined in the MIMECONTF enumerated type to obtain specific information. For example, a browser client can set MIMECONTF_BROWSER to obtain a list of character sets that are appropriate for its character-set-switching menu.

This interface should be used when a client needs information about many code pages at once, or when a client needs to know which code pages fit a certain flag. If information about specific code pages is required, a client should call IMultiLanguage::GetCodePageInfo.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IEnumCodePage Methods

Description

Clone

Not currently implemented.

Next

Retrieves an array of MIMECPINFO structures for the specified number of code pages.

Reset

Resets the Code Page Enumeration Object to the beginning of the enumeration sequence.

Skip

Advances the position of the Code Page Enumeration Object in the enumeration sequence by the specified amount.

Clone

FUNCTION IEnumCodePage_Clone ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppenum AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[3] USING IEnumCodePage_Clone (pthis, ppenum) TO HRESULT

  FUNCTION = HRESULT

END FUNCTION
 

Next

FUNCTION IEnumCodePage_Next ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL celt AS DWORD _
, BYVAL rgelt AS DWORD _
, BYREF pceltFetched AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IEnumCodePage_Next (pthis, celt, rgelt, pceltFetched) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Reset

FUNCTION IEnumCodePage_Reset ( _
  BYVAL pthis AS DWORD PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[5] USING IEnumCodePage_Reset (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Skip

FUNCTION IEnumCodePage_Skip ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL celt AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IEnumCodePage_Skip (pthis, celt) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION